Add checkboxes to your form when you want a user to select one or more items, or none at all. Checkboxes have special characteristics when added to a GridPanel or a form.
When you add a checkbox to a form, the checkbox has a label attached to it automatically. You can change its Text property and specify a label.
| Property | Function |
|---|---|
| Direction | Read-only. Specifies the value of the Direction property of the attribute associated with the CheckBox object. |
| Id | Read-only. By default, automatically generated. Id="CheckBox1" for the first inserted CheckBox, Id="CheckBox2" for the second, and so on. |
| Length | Read-only. Specifies the Length of the attribute associated with the CheckBox object. |
| Name | Read-only. Specifies the name of the attribute associated with the CheckBox object. |
| Primitive | Read-only. Specifies the value of the Primitive property of the attribute associated with the Checkbox object. |
| BackgroundColor | Specifies a background color for the object. Select a color from one of the tabs in the drop-down list. Note that you can specify a custom color. If you change this value, you can restore the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu. |
| BackgroundImage | Specifies an image to appear in the background of the control. The image always appears as a tiled image. |
| Checked | Specifies the initial state of the checkbox. Can also be specified for Radio Buttons. |
| CheckedValue | Specifies the string value to be returned to the server for a single checkbox when the checkbox is checked and the form is submitted at runtime. For multiple checkboxes in a group, this property does not exist. Refer to GridPanel Function for more information on this property. |
| ControlType | Specifies CheckBox as the type of object added to the form. To change the ControlType, choose from the list of available types. |
| Font | Specifies font attributes that are applied directly to the text appearing in the object. If you change this value, you can restore the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu. |
| ForegroundColor | Specifies a foreground color for the object. Select a color from one of the tabs in the drop-down list. Note that you can specify a custom color. If you change this value, you can restore to the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu. |
| Location | Specifies the point in pixels that represents the upper-left corner of the object relative to the upper-left corner of its container as an X and Y location. |
| Size | Specifies the size of the object representing the height and width in pixels. |
| TabIndex | Specifies the index that defines the tab order for the object. |
| Text | Specifies the text to be displayed in the object |
| TextAlign | Specifies whether the text in the object is left-aligned, right-aligned, center-aligned, or justified. |
| TextPosition | Specifies the position of the label relative to the object. The choices are Left and Right (default). |
| ToolTip | Specifies an optional tooltip to appear when the user at runtime hovers the mouse over a control in Winforms. To view the tooltip in the Presentation Client, the user has to hover over the control and press the F1 key. This tooltip is visible only at runtime. |
| Unchecked Value | Specifies the string value to be returned to the server for a single checkbox when the checkbox is unchecked and the form is submitted at run time. For multiple checkboxes in a group, this property does not exist. Refer to GridPanel Function for more information on this property. |