CheckBox
Description
CheckBox represents a check box that can be on (checked) or off (unchecked). The user can check the box to select the option, or uncheck it to deselect the option. If necessary, the component can have three states, such as On, Off and Grayed, to do this, set the AllowGrayed component property to True.
Class: TdbCheckBox
Properties
Property |
Type |
Description |
sqlValue |
String |
Returns the component value, for use in SQL queries. In case of empty value, it returns NULL string |
Alignment |
TAlignment |
Controls the position of the check box's caption. Available values: taRightJustify, taLeftJustify |
AllowGrayed |
Boolean |
Determines whether a check box can be in a dimmed state. If AllowGrayed is set to True, the check box has three possible states: selected, cleared, and dimmed. If AllowGrayed is set to False, the check box has only two possible states: selected and cleared. See the State property to read the value of cbGrayed (dimmed). |
CanFocus |
Boolean |
It checks if the component can get input focus, which is usually necessary before using the SetFocus method. If a component has Visible = False or Enabled = False property, or if the component is located on a parent component with those properties, using the SetFocus method will cause an error. example: if Form1.CheckBox1.CanFocus then Form1.CheckBox1.SetFocus; |
Caption |
String |
Specifies a text string that identifies the control to the user. |
Checked |
Boolean |
Specifies whether the button control is checked. If the AllowGrayed property is set to True, use the State property to read the value of cbGrayed. |
TCursor |
Specifies the image used to represent the mouse pointer when it passes into the region covered by the control. More info. |
|
dbTable |
String |
Determines which database table a component belongs to. |
dbField |
String |
Determines which field of the database table this component belongs to. |
dbIncremSearch |
String |
Allows you to specify the name of the button on the current form with the "Search" or "SQL query" action, which will be automatically pressed when user changes the value of the component. The property is necessary to implement instant search. |
Enabled |
Boolean |
Controls whether the component responds to mouse, keyboard, and timer events. |
Focused |
Boolean |
Determines whether the control has input focus. |
TFont |
Allows you to set font name, size, color and style. More info. |
|
Hint |
String |
Hint contains the text string that appears when the user moves the mouse over the component., see also ShowHint |
Name |
String |
The name of the component. |
ShowHint |
Boolean |
Specifies whether to show the Help Hint when the mouse pointer moves over the component, see also Hint |
State |
TCheckBoxState |
Indicates whether the check box is selected, cleared, or dimmed. Available values: cbChecked, cbUnchecked, cbGrayed |
TabOrder |
Integer |
Indicates the position of the component in its parent's tab order. TabOrder is the order in which child components are visited when the user presses the Tab key. |
TabStop |
Boolean |
Determines whether the user can tab to a control. Use the TabStop to allow or disallow access to the control using the Tab key. |
Tag |
Integer |
Allows you to assign a number to a component for your own needs. |
TagString |
String |
Allows you to assign a string to a component for your own needs. |
WordWrap |
Boolean |
Specifies whether the button text wraps to fit the width of the control. |
Visible |
Boolean |
Specifies whether the component appears onscreen. |
Left |
Integer |
Specifies the horizontal coordinate of the left edge of a component relative to its parent. |
Top |
Integer |
Specifies the vertical coordinate of the upper-left of a component relative to its parent. |
Width |
Integer |
Specifies the horizontal size of the component in pixels. |
Height |
Integer |
Specifies the vertical size of the component in pixels. |
Methods
Method |
Description |
procedure SetFocus |
Gives the input focus to the component. |
Events
Event |
Description |
OnClick |
Occurs when the user clicks the component. |
OnEnter |
Occurs when a component receives the input focus. |
OnExit |
Occurs when the input focus shifts away from one component to another. |
OnKeyDown |
Occurs when a user presses any key while the form has focus. |
OnKeyPress |
Occurs when a key is pressed. Note that this procedure handles printable characters only. |
OnKeyUp |
Occurs when the user releases a key that was pressed. |
OnMouseDown |
Occurs when the user presses a mouse button with the mouse pointer over a component. |
OnMouseEnter |
Occurs when the user moves the mouse into a component. |
OnMouseLeave |
Occurs when the user moves the mouse outside of a component. |
OnMouseMove |
Occurs when the user moves the mouse pointer while the mouse pointer is over a component. |
OnMouseUp |
Occurs when the user releases a mouse button that was pressed with the mouse pointer over a component. |