DocumentID: ECMA-376/Part4/2.16.8
Title: ECMA-376, Part4: 2.16.8 checked (Checkbox Form Field State)
Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006
Warning: Coverted to HTML format by a script known to have bugs

Navigation:

Next: 2.16.9 ddList (Drop-Down List Form Field Properties)
Up: 2.16 Fields & Hyperlinks
Table of contents: Table of contents
Previous: 2.16.7 checkBox (Checkbox Form Field Properties)

`2.16.8 checked` (Checkbox Form Field State)

This element specifies the current state for a checkbox form field. This value shall be used to specify the current value for a checkbox as explicitly chosen for that checkbox, as opposed its default value, which is specified using the default element (§2.16.12).

If this element is omitted, then the parent form field checkbox has no state, and its state shall be determined based on the value of the default element in the checkbox form field properties.

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

<w:ffData> <w:checkBox> <w:checked w:val="true" /> </w:checkBox> </w:ffData>

The checked element specifies that the current state of the checkbox is checked (via an attribute value of true). end example]

Parent Elements

checkBox (§2.16.7)

Attributes	Description
`val` (On/Off Value)	Specifies a binary value for the property defined by the parent XML element. A value of `on`, `1`, or `true` specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of `off`, `0`, or `false` specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property: `<w:... w:val="off"/>` The `val` attribute explicitly declares that the property is turned `off`. end example] The possible values for this attribute are defined by the `ST_OnOff` simple type (§2.18.67).

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:... w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67).

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

<complexType name="CT_OnOff">

<attribute name="val" type="ST_OnOff"/>

</complexType>

Converted to HTML format by ooxmlspec2html 0.1, a Perl script provided by OpenISO.org.