-
Notifications
You must be signed in to change notification settings - Fork 11
/
SuppressSpacingBeforeAfterPageBreak.xml
254 lines (235 loc) · 13.8 KB
/
SuppressSpacingBeforeAfterPageBreak.xml
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
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
<Type Name="SuppressSpacingBeforeAfterPageBreak" FullName="DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak">
<TypeSignature Language="C#" Value="public class SuppressSpacingBeforeAfterPageBreak : DocumentFormat.OpenXml.Wordprocessing.OnOffType" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SuppressSpacingBeforeAfterPageBreak extends DocumentFormat.OpenXml.Wordprocessing.OnOffType" />
<TypeSignature Language="DocId" Value="T:DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak" />
<TypeSignature Language="VB.NET" Value="Public Class SuppressSpacingBeforeAfterPageBreak
Inherits OnOffType" />
<TypeSignature Language="F#" Value="type SuppressSpacingBeforeAfterPageBreak = class
 inherit OnOffType" />
<AssemblyInfo>
<AssemblyName>DocumentFormat.OpenXml</AssemblyName>
<AssemblyVersion>0.0.1.0</AssemblyVersion>
<AssemblyVersion>2.7.2.0</AssemblyVersion>
<AssemblyVersion>2.8.0.0</AssemblyVersion>
<AssemblyVersion>2.8.1.0</AssemblyVersion>
<AssemblyVersion>2.9.0.0</AssemblyVersion>
<AssemblyVersion>2.9.1.0</AssemblyVersion>
<AssemblyVersion>2.10.0.0</AssemblyVersion>
<AssemblyVersion>2.10.1.0</AssemblyVersion>
<AssemblyVersion>2.11.0.0</AssemblyVersion>
<AssemblyVersion>2.11.1.0</AssemblyVersion>
<AssemblyVersion>2.11.2.0</AssemblyVersion>
<AssemblyVersion>2.11.3.0</AssemblyVersion>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
<AssemblyVersion>2.12.1.0</AssemblyVersion>
<AssemblyVersion>2.12.2.0</AssemblyVersion>
<AssemblyVersion>2.12.3.0</AssemblyVersion>
<AssemblyVersion>2.13.0.0</AssemblyVersion>
<AssemblyVersion>2.13.1.0</AssemblyVersion>
<AssemblyVersion>2.14.0.0</AssemblyVersion>
<AssemblyVersion>2.15.0.0</AssemblyVersion>
<AssemblyVersion>2.16.0.0</AssemblyVersion>
<AssemblyVersion>2.17.1.0</AssemblyVersion>
<AssemblyVersion>2.18.0.0</AssemblyVersion>
<AssemblyVersion>2.19.0.0</AssemblyVersion>
<AssemblyVersion>2.20.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.0.1.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>DocumentFormat.OpenXml.Wordprocessing.OnOffType</BaseTypeName>
</Base>
<Interfaces />
<Attributes>
<Attribute FrameworkAlternate="openxml-2.10.0;openxml-2.10.1;openxml-2.11.0;openxml-2.9.0;openxml-2.9.1">
<AttributeName Language="C#">[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]</AttributeName>
<AttributeName Language="F#">[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="openxml-2.10.0;openxml-2.10.1;openxml-2.11.0;openxml-2.12.0;openxml-2.12.1;openxml-2.12.2;openxml-2.12.3;openxml-2.13.0;openxml-2.13.1;openxml-2.14.0">
<AttributeName Language="C#">[DocumentFormat.OpenXml.SchemaAttr(23, "suppressSpBfAfterPgBrk")]</AttributeName>
<AttributeName Language="F#">[<DocumentFormat.OpenXml.SchemaAttr(23, "suppressSpBfAfterPgBrk")>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="openxml-2.15.0;openxml-2.16.0;openxml-2.17.1;openxml-2.18.0;openxml-2.19.0;openxml-2.20.0">
<AttributeName Language="C#">[DocumentFormat.OpenXml.SchemaAttr("w:suppressSpBfAfterPgBrk")]</AttributeName>
<AttributeName Language="F#">[<DocumentFormat.OpenXml.SchemaAttr("w:suppressSpBfAfterPgBrk")>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="openxml-2.7.1;openxml-2.7.2;openxml-2.8.0;openxml-2.8.1;openxml-2.9.0;openxml-2.9.1">
<AttributeName Language="C#">[System.CodeDom.Compiler.GeneratedCode("DomGen", "2.0")]</AttributeName>
<AttributeName Language="F#">[<System.CodeDom.Compiler.GeneratedCode("DomGen", "2.0")>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="openxml-3.0.1">
<AttributeName Language="C#">[System.Runtime.CompilerServices.Nullable(0)]</AttributeName>
<AttributeName Language="F#">[<System.Runtime.CompilerServices.Nullable(0)>]</AttributeName>
</Attribute>
<Attribute FrameworkAlternate="openxml-3.0.1">
<AttributeName Language="C#">[System.Runtime.CompilerServices.NullableContext(1)]</AttributeName>
<AttributeName Language="F#">[<System.Runtime.CompilerServices.NullableContext(1)>]</AttributeName>
</Attribute>
</Attributes>
<Docs>
<summary>
<para>Do Not Use Space Before On First Line After a Page Break.</para>
<para>This class is available in Office 2007 and above.</para>
<para>When the object is serialized out as xml, it's qualified name is w:suppressSpBfAfterPgBrk.</para>
</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
[!INCLUDE[openxmlnoticeiso](~/includes/openxmlnoticeiso.md)]
`suppressSpBfAfterPgBrk (Do Not Use Space Before On First Line After a Page Break)`
This element specifies that applications should not postpone any before paragraph spacing to the first line containing content after a page break.
Typically, a page break defined using the br element (Part 1, §17.3.3.1) is treated as run-level content, which means that although it delimits the end of the page, if there is no content after it within the current paragraph, that the paragraph shall also end on that page. However, in the case where there is additional run-level content within the same paragraph, that content, although part of the same paragraph as the page break, is displayed on the following page.
This leads to a situation where the only run content on the page with the page break is the break itself, with all subsequent content on the following page. In this case, applications shall apply the value specified by the spacing element's before attribute to the first line on the new page (since it is ostensibly the only page with content in that paragraph).
This element, when present with a val attribute value of *true* (or equivalent), specifies the paragraph before spacing shall not be 'postponed' in this way - if the line with the page break has no content, then the spacing element's before attribute is simply ignored.
[*Example*: Consider a WordprocessingML document whose first paragraph specifies that it must be preceded by 50 points of additional spacing:
```xml
<w:p>
<w:pPr>
<w:spacing w:before="1000" />
</w:pPr>
<w:r>
<w:br w:type="page" />
<w:t>This is sample text with 50 points before formatting.</w:t>
</w:r>
</w:p>
```
The default presentation would have the necessary amount of space added to the first line on the second page, as the page break was not preceded by any run content (highlighting has been added to the image below in order to illustrate the additional spacing above the first line):
47ebbee2-d611-4ebf-88e2-8146d050a6ec
However, if this compatibility setting is turned on:
```xml
<w:compat>
<w:suppressSpBfAfterPgBrk />
</w:compat>
```
Then the spacing must not be added above the first line on the page (it is essentially ignored), resulting in the following output:
4448c4d4-93e0-4efa-ad69-097f2c23f3a5
*end example*]
|Parent Elements|
|---------------------|
|compat (Part 1, §17.15.1.21)|
This element’s content model is defined by the common boolean property definition in Part 1, §17.17.4.
[!INCLUDE[openxmlnoticeiso](~/includes/openxmlcopyrightiso.md)]
]]></format>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SuppressSpacingBeforeAfterPageBreak ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberSignature Language="DocId" Value="M:DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak.#ctor" />
<MemberSignature Language="VB.NET" Value="Public Sub New ()" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>DocumentFormat.OpenXml</AssemblyName>
<AssemblyVersion>0.0.1.0</AssemblyVersion>
<AssemblyVersion>2.7.2.0</AssemblyVersion>
<AssemblyVersion>2.8.0.0</AssemblyVersion>
<AssemblyVersion>2.8.1.0</AssemblyVersion>
<AssemblyVersion>2.9.0.0</AssemblyVersion>
<AssemblyVersion>2.9.1.0</AssemblyVersion>
<AssemblyVersion>2.10.0.0</AssemblyVersion>
<AssemblyVersion>2.10.1.0</AssemblyVersion>
<AssemblyVersion>2.11.0.0</AssemblyVersion>
<AssemblyVersion>2.11.1.0</AssemblyVersion>
<AssemblyVersion>2.11.2.0</AssemblyVersion>
<AssemblyVersion>2.11.3.0</AssemblyVersion>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
<AssemblyVersion>2.12.1.0</AssemblyVersion>
<AssemblyVersion>2.12.2.0</AssemblyVersion>
<AssemblyVersion>2.12.3.0</AssemblyVersion>
<AssemblyVersion>2.13.0.0</AssemblyVersion>
<AssemblyVersion>2.13.1.0</AssemblyVersion>
<AssemblyVersion>2.14.0.0</AssemblyVersion>
<AssemblyVersion>2.15.0.0</AssemblyVersion>
<AssemblyVersion>2.16.0.0</AssemblyVersion>
<AssemblyVersion>2.17.1.0</AssemblyVersion>
<AssemblyVersion>2.18.0.0</AssemblyVersion>
<AssemblyVersion>2.19.0.0</AssemblyVersion>
<AssemblyVersion>2.20.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.0.1.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<summary>
Initializes a new instance of the SuppressSpacingBeforeAfterPageBreak class.
</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="CloneNode">
<MemberSignature Language="C#" Value="public override DocumentFormat.OpenXml.OpenXmlElement CloneNode (bool deep);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance class DocumentFormat.OpenXml.OpenXmlElement CloneNode(bool deep) cil managed" />
<MemberSignature Language="DocId" Value="M:DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak.CloneNode(System.Boolean)" />
<MemberSignature Language="VB.NET" Value="Public Overrides Function CloneNode (deep As Boolean) As OpenXmlElement" />
<MemberSignature Language="F#" Value="override this.CloneNode : bool -> DocumentFormat.OpenXml.OpenXmlElement" Usage="suppressSpacingBeforeAfterPageBreak.CloneNode deep" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>DocumentFormat.OpenXml</AssemblyName>
<AssemblyVersion>0.0.1.0</AssemblyVersion>
<AssemblyVersion>2.7.2.0</AssemblyVersion>
<AssemblyVersion>2.8.0.0</AssemblyVersion>
<AssemblyVersion>2.8.1.0</AssemblyVersion>
<AssemblyVersion>2.9.0.0</AssemblyVersion>
<AssemblyVersion>2.9.1.0</AssemblyVersion>
<AssemblyVersion>2.10.0.0</AssemblyVersion>
<AssemblyVersion>2.10.1.0</AssemblyVersion>
<AssemblyVersion>2.11.0.0</AssemblyVersion>
<AssemblyVersion>2.11.1.0</AssemblyVersion>
<AssemblyVersion>2.11.2.0</AssemblyVersion>
<AssemblyVersion>2.11.3.0</AssemblyVersion>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
<AssemblyVersion>2.12.1.0</AssemblyVersion>
<AssemblyVersion>2.12.2.0</AssemblyVersion>
<AssemblyVersion>2.12.3.0</AssemblyVersion>
<AssemblyVersion>2.13.0.0</AssemblyVersion>
<AssemblyVersion>2.13.1.0</AssemblyVersion>
<AssemblyVersion>2.14.0.0</AssemblyVersion>
<AssemblyVersion>2.15.0.0</AssemblyVersion>
<AssemblyVersion>2.16.0.0</AssemblyVersion>
<AssemblyVersion>2.17.1.0</AssemblyVersion>
<AssemblyVersion>2.18.0.0</AssemblyVersion>
<AssemblyVersion>2.19.0.0</AssemblyVersion>
<AssemblyVersion>2.20.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.0.1.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>DocumentFormat.OpenXml.OpenXmlElement</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="deep" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="deep">true to recursively clone the subtree under the specified node; false to clone only the node itself.</param>
<summary>Creates a duplicate of this node.</summary>
<returns>Returns the cloned node.</returns>
<remarks>To be added.</remarks>
<inheritdoc />
</Docs>
</Member>
<Member MemberName="LocalName">
<MemberSignature Language="C#" Value="public override string LocalName { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance string LocalName" />
<MemberSignature Language="DocId" Value="P:DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak.LocalName" />
<MemberSignature Language="VB.NET" Value="Public Overrides ReadOnly Property LocalName As String" />
<MemberSignature Language="F#" Value="member this.LocalName : string" Usage="DocumentFormat.OpenXml.Wordprocessing.SuppressSpacingBeforeAfterPageBreak.LocalName" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>DocumentFormat.OpenXml</AssemblyName>
<AssemblyVersion>0.0.1.0</AssemblyVersion>
<AssemblyVersion>2.7.2.0</AssemblyVersion>
<AssemblyVersion>2.8.0.0</AssemblyVersion>
<AssemblyVersion>2.8.1.0</AssemblyVersion>
<AssemblyVersion>2.9.0.0</AssemblyVersion>
<AssemblyVersion>2.9.1.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
</Type>