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

 example: SQLExecute ('INSERT INTO tablename (fieldname) VALUES ('+Form1.CheckBox1.sqlValue+')');

 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.

 Cursor

 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.

 Font

 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.