ControlProperties class

Office 2013 and later

Control Properties. When the object is serialized out as xml, its qualified name is m:ctrlPr.

Namespace:  DocumentFormat.OpenXml.Math
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.

[ISO/IEC 29500-1 1st Edition]

ctrlPr (Control Properties)

This element specifies properties on control characters; that is, object characters that cannot be selected. Examples of control characters are n-ary operators (excluding their limits and bases), fraction bars (excluding the numerator and denominator), and grouping characters (excluding the base). ctrlPr allows formatting properties to be stored on these control characters. The control character inherits its formatting from the paragraph formatting; ctrlPr contains the formatting differences between the control character and the paragraph formatting.

If this element is omitted, the character properties of the first control character are the same as the first character in the math object.

[Example: The example below shows that the control character is of font Cambria Math. All other formatting, such as text size and color, are the same as the paragraph.

<m:ctrlPr>
  <w:rPr>
    <w:rFonts w:ascii="Cambria Math" w:hAnsi="Cambria Math"/>
  </w:rPr>
</m:ctrlPr>

end example]

CtrlPr is also used to save properties on characters used in the built-down form of an instance of mathematical text that are not displayed in Professional form. For example, the mathematical text (in linear form) ∫_0^1 might have color on the _ or ^. Though these characters are not displayed in Professional form, their formatting is stored such that their formatting will roundtrip through build up and build down.

Parent Elements

accPr (§22.1.2.2); barPr (§22.1.2.8); borderBoxPr (§22.1.2.12); boxPr (§22.1.2.14); deg (§22.1.2.26); den (§22.1.2.28); dPr (§22.1.2.31); e (§22.1.2.32); eqArrPr (§22.1.2.35); fName (§22.1.2.37); fPr (§22.1.2.38); funcPr (§22.1.2.40); groupChrPr (§22.1.2.42); lim (§22.1.2.52); limLowPr (§22.1.2.55); limUppPr (§22.1.2.57); mPr (§22.1.2.68); naryPr (§22.1.2.72); num (§22.1.2.75); phantPr (§22.1.2.82); radPr (§22.1.2.89); sPrePr (§22.1.2.100); sSubPr (§22.1.2.102); sSubSupPr (§22.1.2.104); sSupPr (§22.1.2.106); sub (§22.1.2.112); sup (§22.1.2.114)

Child Elements

Subclause

del (Deleted Math Control Character)

§17.13.5.13

ins (Inserted Math Control Character)

§17.13.5.16

rPr (Run Properties)

§17.3.2.28

[Note: The W3C XML Schema definition of this element’s content model (CT_CtrlPr) is located in §A.6.1. end note]

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: