@...CHECKBOX
DEFINE CHECKBOX 
Creates a checkbox control.
  

A check box consists of a square box and application-defined text (label), that indicates a choice the user can make by selecting the button.

SYNTAX

Standard Window:

@ <nRow> ,<nCol> CHECKBOX<ControlName>
[ ID <
nId> ]
[ OF | PARENT | DIALOG <
ParentWindowName> ]
CAPTION<
cCaption>
[ WIDTH <
nWidth>] [ HEIGHT <nHeight> ]
[ FIELD <
cField> ]
[ VALUE <
lValue> ]
[ FONT <
cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
aBackColor> ]
[ FONTCOLOR <
aFontColor> ]
[ ON GOTFOCUS <
OnGotFocusProcedur> | <bBlock> ]
[ ON CHANGE <
OnChangeProcedure> | <bBlock> ]
[ ON LOSTFOCUS <
OnLostFocusProcedure> | <bBlock> ]
[ TRANSPARENT ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]
[ NOTABSTOP ]
[ LEFTJUSTIFY ]
[ THREESTATE ]

Dialog Window:

REDEFINE CHECKBOX<ControlName>
ID <
nId>
[ OF | PARENT | DIALOG <
ParentWindowName> ]
[ CAPTION<
cCaption> ]
[ FIELD <
cField> ]
[ VALUE <
lValue> ]
[ FONT <
cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
aBackColor> ]
[ FONTCOLOR <
aFontColor> ]
[ ON GOTFOCUS <
OnGotFocusProcedur> | <bBlock> ]
[ ON CHANGE <
OnChangeProcedure> | <bBlock> ]
[ ON LOSTFOCUS <
OnLostFocusProcedure> | <bBlock> ]
[ TRANSPARENT ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]
[ NOTABSTOP ]
[ LEFTJUSTIFY ]
[ THREESTATE ]

Alternate Syntax:

DEFINE CHECKBOX <ControlName>

[ ID <nId> ]
[ PARENT <
ParentWindowName> ]
COL <
nCol>
ROW <
nRow>
WIDTH <
nWidth>
HEIGHT <
nHeight>
CAPTION<
cCaption>
[ FIELD <
cField> ]
[ VALUE <
lValue>]
[ FONTNAME <
cFontname>
[ FONTSIZE <
nFontsize> ]
[ FONTBOLD < .T. | .F.> ]
[ FONTITALIC < .T. | .F.> ]
[ FONTUNDERLINE < .T. | .F.> ]
[ FONTSTRIKEOUT < .T. | .F.> ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
aBackColor> ]
[ FONTCOLOR <
aFontcolorRGBArray> ]
[ ONGOTFOCUS <
OnGotFocusProcedur> | <bBlock> ]
[ ONCHANGE <
OnChangeProcedure> | <bBlock> ]
[ ONLOSTFOCUS <
OnLostFocusProcedure> | <bBlock> ]
[ HELPID <
nHelpId> ]
[ TRANSPARENT < .T. | .F.> ]
[ INVISIBLE < .T. | .F.> ]
[ NOTABSTOP < .T. | .F.> ]
[ LEFTJUSTIFY < .T. | .F.> ]
[ THREESTATE < .T. | .F.> ]

END CHECKBOX

DESCRIPTION:
nRow, nCol
Position in the area of ??the window in pixels.
nWidth, nHeigth
The desired size of the CheckBox Control in pixels.
nId
The ID identifier this Control in Dialog Window
ControlName
A reference to the CheckBox Control
ParentWindowName
A reference to the Parent Window.
nHelpId
The help topic identifier for this Control


PROPERTIES:

·   Value
Set / Gets CheckBox value.
·   Enabled
Set / Gets enabled state of a CheckBox control
·   Visible          
Set / Gets visible a CheckBox control.
·   Row
Set / Gets row position of a CheckBox control.
·   Col   
Set / Gets column position of a CheckBox control.
·   Width
Set / Gets width of a CheckBox control.
·   Height
Set / Gets height of a CheckBox control.
·   Caption
Set / Gets caption of a CheckBox control.
·   FontName
Set / Gets CheckBox control's font name.
·   FontSize
Set / Gets CheckBox control's font size.
·   FontBold
Set / Gets CheckBox control's font bold property
·   FontItalic
Set / Gets CheckBox control's font italic property
Set / Gets CheckBox control's font underline property
Set / Gets CheckBox control's font strikeout property
·   ToolTip
Set / Gets CheckBox control's tooltip text.
·   BackColor
Set / Gets the foreground color for text within the CheckBox
·   FontColor
Set / Gets the background color for text within the CheckBox
·   Cargo
Set / Gets user property 'Cargo' for CheckBox control
·   Name (R)
Retrieves the name of a CheckBox control.
·   Parent (D)
Set the name as character identifier of the parent window.
·   Field (D)
 
·   HelpId (D)
Set the numeric help topic identifier of the control.
·   NoTabStop (D)
Sets whether an element behavior can't receive focus and participate in the tabbing sequence

Available at control definition only
R: Read-Only

EVENTS:

 

·   OnGotFocus
An action to be performed when getting the focus
·   OnChange
An action to be performed when generic changing of the control
An action to be performed when losing the focus.

METHODS:
·   Show
Shows a CheckBox control
·   Hide
Hides a CheckBox control
·   SetFocus
Gives the focus to a CheckBox control
·   Release
Releases a CheckBox control from memory
·   Refresh
Repaint a Control
·   Save
Save data for Control CheckBox
·   SaveAs
Save a CheckBox control as BitMap file.

EXAMPLE:

see demos in :
\Samples\Advanced\ICheckBox
\Samples\Advanced\ICheckBox_Grid
\Samples\Advanced\ICheckBox_ThreeState