check

Provides a simple check box to record a selected or not selected answer from a user. A selected check box appears filled while a deselected box appears empty.

The exact appearance of the check box is platform-dependent; but the shape is rectangular. The check box appears as a normal check box for the users of each platform.

Available options

acclabel, active, bgcolor, focused, fontcolor, fontinfo, help, itemlocation, itemnext, itemprevious, keypress, label, labelbgcolor, labelborder, labelfontcolor, labelfontinfo, mouseover, next, previous, printbgcolor, printfontcolor, printlabelbgcolor, printlabelfontcolor, printvisible, readonly, saveformat, size, suppresslabel, value, visible, xformsenabled, xformsreadonly, xformsrequired, xformsvalid, xforms:input

Example

This value option setting in this check box is on, so the check box will appear selected when it displays. The item's label is Activate Health Plan, and the label will display in a Times 14 Bold font colored blue.

   <check sid="healthPlan_check">
      <value>on</value>
      <label>Active Health Plan</label>
      <labelfontinfo>
         <fontname>Times</fontname>
         <size>14</size>
         <effect>bold</effect>
      </labelfontinfo>
      <labelfontcolor>blue</labelfontcolor>
   </check>

Usage details

  1. This item cannot be used in conjunction with the XForms-based checkgroup, which uses xforms:itemset and xforms:item instead. The check item is deprecated because it does not work in panes and tables, and form authors should use the checkgroup item instead.
  2. The value option setting indicates the user's answer. If the user selects or checks the check box, the value option contains on, otherwise it contains off. The default value is off.
  3. Check boxes do not belong to groups like radio buttons - each check box may be turned on or off independently of the others.
  4. The label option defines the label for the check box. The label appears before the check box and aligned with the box's left edge. There is no default label.
  5. When setting the size option of a check box, the height and width of the bounding box will be based on the average character size for the font in use (set with the fontinfo option).
  6. The fontcolor option determines the color of the check box fill pattern (defaults to red).
  7. For check items that contain an xforms:input option, the on or off value is translated into true or false, respectively, when stored in the data model.
Parent topic: Items