[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

rPr (Run Properties For Structured Document Tag Contents)

This element specifies the set of run properties which shall be applied to the text entered into the parent structured document tag in replacement of placeholder text. When placeholder text is present in a structured document tag, its formatting is often different than the desired underlying formatting, and this element specifies the formatting which shall be used for non-placeholder text contents when they are initially added to the control.

If this element is not present, the inserted is unformatted, as with any other run of text - it shall not inherit the properties of the placeholder text.

[Example: Consider the following structured document tag:

<w:sdt>
<w:sdtPr>
<w:placeholder>
<w:docPart w:val="TestPlaceholderDocPart"/>
</w:placeholder>
<w:showingPlcHdr/>
<w:rPr>
<w:rStyle w:val="UserName"/>
</w:rPr>

</w:sdtPr>
<w:sdtContent>
<w:r>
<w:rPr>
<w:rStyle w:val="PlaceholderText"/>
</w:rPr>
<w:t>[Type Your Name Here]</w:t>
</w:r>
</w:sdtContent>
</w:sdt>

This structured document tag specifies that its current contents are placeholder text via the showingPlcHdr element (§2.5.2.38), and that text has the PlaceholderText character style applied to it.

Now, assume that that style created grey shaded text (typical for placeholder text). This formatting would clearly not be desirable for any text entered into the structured document tag. Therefore, when this text is added, the rPr element in the sdtPr is used to store the formatting on the resulting text.

In this example, the text which initially populates the control shall be formatted with the UserName character style. end example]

Parent Elements

sdtPr2.5.2.37)

 

Child Elements

Subclause

b (Bold)

§2.3.2.1

bCs (Complex Script Bold)

§2.3.2.2

bdr (Text Border)

§2.3.2.3

caps (Display All Characters As Capital Letters)

§2.3.2.4

color (Run Content Color)

§2.3.2.5

cs (Use Complex Script Formatting on Run)

§2.3.2.6

dstrike (Double Strikethrough)

§2.3.2.7

eastAsianLayout (East Asian Typography Settings)

§2.3.2.8

effect (Animated Text Effect)

§2.3.2.9

em (Emphasis Mark)

§2.3.2.10

emboss (Embossing)

§2.3.2.11

fitText (Manual Run Width)

§2.3.2.12

highlight (Text Highlighting)

§2.3.2.13

i (Italics)

§2.3.2.14

iCs (Complex Script Italics)

§2.3.2.15

imprint (Imprinting)

§2.3.2.16

kern (Font Kerning)

§2.3.2.17

lang (Languages for Run Content)

§2.3.2.18

noProof (Do Not Check Spelling or Grammar)

§2.3.2.19

oMath (Office Open XML Math)

§2.3.2.20

outline (Display Character Outline)

§2.3.2.21

position (Vertically Raised or Lowered Text)

§2.3.2.22

rFonts (Run Fonts)

§2.3.2.24

rPrChange (Revision Information for Run Properties)

§2.13.5.32

rStyle (Referenced Character Style)

§2.3.2.27

rtl (Right To Left Text)

§2.3.2.28

shadow (Shadow)

§2.3.2.29

shd (Run Shading)

§2.3.2.30

smallCaps (Small Caps)

§2.3.2.31

snapToGrid (Use Document Grid Settings For Inter-Character Spacing)

§2.3.2.32

spacing (Character Spacing Adjustment)

§2.3.2.33

specVanish (Paragraph Mark Is Always Hidden)

§2.3.2.34

strike (Single Strikethrough)

§2.3.2.35

sz (Font Size)

§2.3.2.36

szCs (Complex Script Font Size)

§2.3.2.37

u (Underline)

§2.3.2.38

vanish (Hidden Text)

§2.3.2.39

vertAlign (Subscript/Superscript Text)

§2.3.2.40

w (Expanded/Compressed Text)

§2.3.2.41

webHidden (Web Hidden Text)

§2.3.2.42

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_RPr">

   <sequence>

   <group ref="EG_RPrContent" minOccurs="0"/>

   </sequence>

</complexType>