17.5.2.27 rPr

This element specifies the set of run properties that shall be applied to the text entered into the nearest ancestor 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 (17.5.2.39), 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]

The W3C XML Schema definition of this element’s content model (CT_RPr) is located in A.1. Each child element from the above table shall not occur more than once. [Note: This restriction is not reflected in the element’s content model due to limitations of W3C XML Schema language. end note]