ControlProperties Class
Control Properties.When the object is serialized out as xml, its qualified name is m:ctrlPr.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Math.ControlProperties
Namespace: DocumentFormat.OpenXml.Math
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(InsertedMathControl))> _
<ChildElementInfoAttribute(GetType(MoveToMathControl))> _
<ChildElementInfoAttribute(GetType(RunProperties))> _
<ChildElementInfoAttribute(GetType(DeletedMathControl))> _
<ChildElementInfoAttribute(GetType(MoveFromMathControl))> _
Public Class ControlProperties _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As ControlProperties
[ChildElementInfoAttribute(typeof(InsertedMathControl))]
[ChildElementInfoAttribute(typeof(MoveToMathControl))]
[ChildElementInfoAttribute(typeof(RunProperties))]
[ChildElementInfoAttribute(typeof(DeletedMathControl))]
[ChildElementInfoAttribute(typeof(MoveFromMathControl))]
public class ControlProperties : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
DocumentFormat.OpenXml.Wordprocessing.RunProperties <w:rPr>
DocumentFormat.OpenXml.Wordprocessing.InsertedMathControl <w:ins>
DocumentFormat.OpenXml.Wordprocessing.DeletedMathControl <w:del>
DocumentFormat.OpenXml.Wordprocessing.MoveFromMathControl <w:moveFrom>
DocumentFormat.OpenXml.Wordprocessing.MoveToMathControl <w:moveTo>
[ISO/IEC 29500-1 1st Edition]
22.1.2.23 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.
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.