1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
Feature: Get or set paragraph formatting properties
In order to customize the formatting of paragraphs in a document
As a python-docx developer
I need a ParagraphFormat object with read/write formatting properties
Scenario: Get tab stops
Given a paragraph format
Then paragraph_format.tab_stops is a TabStops object
Scenario Outline: Get paragraph alignment
Given a paragraph format having <align-type> alignment
Then paragraph_format.alignment is <value>
Examples: paragraph_format.alignment values
| align-type | value |
| inherited | None |
| center | WD_ALIGN_PARAGRAPH.CENTER |
| right | WD_ALIGN_PARAGRAPH.RIGHT |
Scenario Outline: Set paragraph alignment
Given a paragraph format having <align-type> alignment
When I assign <new-value> to paragraph_format.alignment
Then paragraph_format.alignment is <value>
Examples: paragraph_format.alignment assignment results
| align-type | new-value | value |
| inherited | WD_ALIGN_PARAGRAPH.CENTER | WD_ALIGN_PARAGRAPH.CENTER |
| center | WD_ALIGN_PARAGRAPH.RIGHT | WD_ALIGN_PARAGRAPH.RIGHT |
| right | None | None |
Scenario Outline: Get paragraph spacing
Given a paragraph format having <setting> space <side>
Then paragraph_format.space_<side> is <value>
Examples: paragraph_format spacing values
| side | setting | value |
| before | inherited | None |
| before | 24 pt | 304800 |
| after | inherited | None |
| after | 42 pt | 533400 |
Scenario Outline: Set paragraph spacing
Given a paragraph format having <setting> space <side>
When I assign <new-value> to paragraph_format.space_<side>
Then paragraph_format.space_<side> is <value>
Examples: paragraph_format spacing assignment results
| side | setting | new-value | value |
| before | inherited | Pt(12) | 152400 |
| before | 24 pt | Pt(18) | 228600 |
| before | 24 pt | None | None |
| after | inherited | Pt(12) | 152400 |
| after | 42 pt | Pt(18) | 228600 |
| after | 42 pt | None | None |
Scenario Outline: Get line spacing
Given a paragraph format having <setting> line spacing
Then paragraph_format.line_spacing is <value>
Then paragraph_format.line_spacing_rule is <rule-value>
Examples: paragraph_format.line_spacing values
| setting | value | rule-value |
| inherited | None | None |
| 14 pt | 177800 | WD_LINE_SPACING.EXACTLY |
| double | 2.0 | WD_LINE_SPACING.DOUBLE |
Scenario Outline: Set line spacing
Given a paragraph format having <setting> line spacing
When I assign <new-value> to paragraph_format.line_spacing
Then paragraph_format.line_spacing is <value>
Then paragraph_format.line_spacing_rule is <rule-value>
Examples: paragraph_format.line_spacing assignment results
| setting | new-value | value | rule-value |
| inherited | Pt(14) | 177800 | WD_LINE_SPACING.EXACTLY |
| 14 pt | 2 | 2.0 | WD_LINE_SPACING.DOUBLE |
| double | 1.75 | 1.75 | WD_LINE_SPACING.MULTIPLE |
| inherited | 1.0 | 1.0 | WD_LINE_SPACING.SINGLE |
| 14 pt | 1.5 | 1.5 | WD_LINE_SPACING.ONE_POINT_FIVE |
Scenario Outline: Set line spacing rule
Given a paragraph format having <setting> line spacing
When I assign <new-value> to paragraph_format.line_spacing_rule
Then paragraph_format.line_spacing is <value>
Then paragraph_format.line_spacing_rule is <rule-value>
Examples: paragraph_format.line_spacing_rule assignment results
| setting | new-value | value | rule-value |
| 14 pt | WD_LINE_SPACING.DOUBLE | 2.0 | WD_LINE_SPACING.DOUBLE |
| double | WD_LINE_SPACING.SINGLE | 1.0 | WD_LINE_SPACING.SINGLE |
| 14 pt | WD_LINE_SPACING.AT_LEAST | 177800 | WD_LINE_SPACING.AT_LEAST |
| 14 pt | None | 1.1666 | WD_LINE_SPACING.MULTIPLE |
Scenario Outline: Get paragraph indents
Given a paragraph format having <type> indent of <setting>
Then paragraph_format.<type>_indent is <value>
Examples: paragraph_format indent values
| type | setting | value |
| first_line | inherit | None |
| first_line | 18 pt | 228600 |
| first_line | -17.3 pt | -219710 |
| left | inherit | None |
| left | 46.1 pt | 585470 |
| right | inherit | None |
| right | 17.3 pt | 219710 |
Scenario Outline: Set paragraph indents
Given a paragraph format having <type> indent of <setting>
When I assign <new-value> to paragraph_format.<type>_indent
Then paragraph_format.<type>_indent is <value>
Examples: paragraph_format indent assignment results
| type | setting | new-value | value |
| first_line | inherit | 18 pt | 228600 |
| first_line | 18 pt | -18 pt | -228600 |
| first_line | -17.3 pt | None | None |
| left | inherit | 36 pt | 457200 |
| left | 46.1 pt | -12 pt | -152400 |
| left | 46.1 pt | None | None |
| right | inherit | 24 pt | 304800 |
| right | 17.3 pt | -6 pt | -76200 |
| right | 17.3 pt | None | None |
Scenario Outline: Get On/Off paragraph property
Given a paragraph format having <prop-name> set <state>
Then paragraph_format.<prop-name> is <value>
Examples: ParagraphFormat On/Off property values
| prop-name | state | value |
| keep_together | to inherit | None |
| keep_together | On | True |
| keep_together | Off | False |
| keep_with_next | to inherit | None |
| keep_with_next | On | True |
| keep_with_next | Off | False |
| page_break_before | to inherit | None |
| page_break_before | On | True |
| page_break_before | Off | False |
| widow_control | to inherit | None |
| widow_control | On | True |
| widow_control | Off | False |
Scenario Outline: Set On/Off paragraph property
Given a paragraph format having <prop-name> set <state>
When I assign <new-value> to paragraph_format.<prop-name>
Then paragraph_format.<prop-name> is <value>
Examples: ParagraphFormat On/Off property values
| prop-name | state | new-value | value |
| keep_together | to inherit | True | True |
| keep_together | On | False | False |
| keep_together | Off | None | None |
| keep_with_next | to inherit | False | False |
| keep_with_next | Off | True | True |
| keep_with_next | On | None | None |
| page_break_before | to inherit | True | True |
| page_break_before | On | False | False |
| page_break_before | Off | None | None |
| widow_control | to inherit | False | False |
| widow_control | Off | True | True |
| widow_control | On | None | None |
|
