2.4.1.6 Check Box Control

A check box control is a bi-state leaf control that has a value when it is selected and a different value when it is cleared. The following table describes the symbols for a check box control.

Symbol

Description

SIMPLE_CHECK_BOX

A control that has two states, checked and unchecked. The unchecked state tends to be represented as a blank white square, and the checked state has a mark, which is commonly a check mark, contained in the white square.

CHECK_BOX_WITH_CONDITIONAL_FORMATTING

Similar to SIMPLE_CHECK_BOX, with the addition that the control can be disabled conditionally. A disabled checkbox does not allow the user to directly toggle the control between its two states.

SIMPLE_CHECK_BOX:

 <input class="xdBehavior_Boolean" title="ANY_STRING1" type="checkbox" (accessKey="SINGLE_CHARACTER")? xd:binding="LEAF_XPATH1" xd:boundProp="xd:value" (CHECK_BOX_SINGLE_VALUE | CHECK_BOX_BOTH_VALUES) (tabIndex="TAB_INDEX")? xd:xctname="CheckBox" xd:CtrlId="CONTROL_ID" (xd:postbackModel="POSTBACKMODEL")? (style="CHECK_BOX_STYLE")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="xd:value">
         <xsl:value-of select="LEAF_XPATH1" />
     </xsl:attribute>
     <xsl:if test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="CHECKED">CHECKED</xsl:attribute>
     </xsl:if>
     CHECK_FOR_GETDOM_END1
 </input>
 (ANY_STRING2)?
  

CHECK_BOX_WITH_CONDITIONAL_FORMATTING:

 <input class="xdBehavior_Boolean" title="ANY_STRING1" type="checkbox" (accessKey="SINGLE_CHARACTER")? xd:binding="LEAF_XPATH1" xd:boundProp="xd:value" (CHECK_BOX_SINGLE_VALUE | CHECK_BOX_BOTH_VALUES) (tabIndex="TAB_INDEX")? xd:xctname="CheckBox" xd:CtrlId="CONTROL_ID" (xd:postbackModel="POSTBACKMODEL")? (style="CHECK_BOX_STYLE")?>
     CHECK_FOR_GETDOM_BEGIN1
     <xsl:attribute name="style">
         <xsl:choose>
             (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONY">STYLE_CAPTION</xsl:when>)+
         </xsl:choose>
     </xsl:attribute>
     (<xsl:choose>
         (<xsl:when test="BOOLEAN_XPATH_EXPRESSIONY">
             <xsl:attribute name="disabled">true</xsl:attribute> 
         </xsl:when>)+
     </xsl:choose>)?
     <xsl:attribute name="xd:value">
         <xsl:value-of select="LEAF_XPATH1" /> 
     </xsl:attribute>
     <xsl:if test="BOOLEAN_XPATH_EXPRESSION">
         <xsl:attribute name="CHECKED">CHECKED</xsl:attribute> 
     </xsl:if>
     CHECK_FOR_GETDOM_END1
 </input>
 (ANY_STRING2)?

CHECK_BOX_ONVALUE:

 xd:onValue="(ISO_646_DIGIT+)|(&quot;ANY_STRING&quot;)" 

CHECK_BOX_OFFVALUE:

 xd:offValue="(ISO_646_DIGIT+)|(&quot;ANY_STRING&quot;)"

CHECK_BOX_SINGLE_VALUE: MUST be "CHECK_BOX_OFFVALUE" or "CHECK_BOX_ONVALUE".

CHECK_BOX_BOTH_VALUES: "CHECK_BOX_OFFVALUE" and "CHECK_BOX_ONVALUE".

CHECK_BOX_STYLE: Semicolon-delimited list of (STYLE_MARGIN?, STYLE_WIDTH?, STYLE_HEIGHT?, STYLE_VERTICAL_ALIGN?, STYLE_COLOR?, STYLE_BACKGROUND_COLOR?, STYLE_BORDER?, STYLE_FONT?, STYLE_TEXT_DECORATION?).

The following table lists control-specific attributes used by the check box control.

Attribute

Section

xd:binding

2.4.2.6

xd:boundProp

2.4.2.9

xd:CtrlId

2.4.2.10

xd:offValue

2.4.2.27

xd:onValue

2.4.2.28

xd:postbackModel

2.4.2.29

xd:value

2.4.2.34

xd:xctname

2.4.2.35