CheckBox Class

Checkbox Form Field Properties.When the object is serialized out as xml, its qualified name is w:checkBox.

Inheritance Hierarchy


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


<ChildElementInfoAttribute(GetType(Checked))> _
<ChildElementInfoAttribute(GetType(AutomaticallySizeFormField))> _
<ChildElementInfoAttribute(GetType(DefaultCheckBoxFormFieldState))> _
<ChildElementInfoAttribute(GetType(FormFieldSize))> _
Public Class CheckBox _
    Inherits OpenXmlCompositeElement
Dim instance As CheckBox
public class CheckBox : OpenXmlCompositeElement


The following table lists the possible child types:

  • FormFieldSize <w:size>

  • AutomaticallySizeFormField <w:sizeAuto>

  • DefaultCheckBoxFormFieldState <w:default>

  • Checked <w:checked>

[ISO/IEC 29500-1 1st Edition]

17.16.2 checkBox (Checkbox Form Field Properties)

This element specifies a set of properties which shall be associated with the parent FORMCHECKBOX checkbox form field (§ within the document.

If the parent form field is not a checkbox (i.e. its field code does not have a value of FORMCHECKBOX), then these properties can be ignored.

[Example: Consider the following WordprocessingML fragment for the properties of a checkbox form field:

<w:size w:val="20" />
    <w:checked w:val="true" />

The checkBox element specifies that it contains a set of properties for the parent checkbox form field. In this case, these properties specify that the size of the checkbox must be exactly 10 points via the size element (§17.16.29), and that the current state of the checkbox must be checked via the checked element (§17.16.8). end example]

Parent Elements

ffData (§17.16.17)

Child Elements


checked (Checkbox Form Field State)


default (Default Checkbox Form Field State)


size (Checkbox Form Field Size)


sizeAuto (Automatically Size Form Field)


[Note: The W3C XML Schema definition of this element’s content model (CT_FFCheckBox) is located in §A.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.

See Also


CheckBox Members

DocumentFormat.OpenXml.Wordprocessing Namespace