@...LABEL
DEFINE LABEL 
Create a Label control
  

Creates a label control.

SYNTAX

Standard Window:

@ <nRow> ,<nCol> LABEL <ControlName>
[ ID <
nId> ]
[ OF | PARENT | DIALOG <
ParentWindowName> ]
VALUE <
cValue>
[ ACTION | ONCLICK | ON CLICK <
OnClickProcedure> | <bBlock> ]
[ ON MOUSEHOVER | ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ON MOUSELEAVE | ONMOUSELEAVE  <
OnLeaveProcedure> | <bBlock> ]
[ WIDTH <
nWidth> ]
[ HEIGHT <
nHeight> ]
[ AUTOSIZE ]
[ FONT <
cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
anBackColort> ]
[ FONTCOLOR <
anFontColor> ]
[ BORDER ]
[ CLIENTEDGE ]
[ HSCROLL ]
[ VSCROLL ]
[ TRANSPARENT ]
[ BLINK ]
[ RIGHTALIGN | CENTERALIGN ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]

Dialog Window:

REDEFINE LABEL <ControlName>
ID <
nId>
[ OF | PARENT | DIALOG <
ParentWindowName> ]
VALUE <
cValue>
[ ACTION | ONCLICK | ON CLICK <
OnClickProcedure> | <bBlock> ]
[ ON MOUSEHOVER | ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ON MOUSELEAVE | ONMOUSELEAVE  <
OnLeaveProcedure> | <bBlock> ]
[ AUTOSIZE ]
[ FONT <
cFontName> SIZE <nFontSize> ]
[ BOLD ] [ ITALIC ] [ UNDERLINE ] [ STRIKEOUT ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
anBackColor> ]
[ FONTCOLOR <
anFontColor> ]
[ BORDER ]
[ CLIENTEDGE ]
[ HSCROLL ]
[ VSCROLL ]
[ TRANSPARENT ]
[ BLINK ]
[ RIGHTALIGN | CENTERALIGN ]
[ VCENTERALIGN ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]

Alternate Syntax:

DEFINE LABEL

[ ID <nId> ]
[ PARENT <
ParentWindowName> ]
COL <
nCol>
ROW <
nRow>
VALUE <
cValue>
[ ACTION <
OnClickProcedure> | <bBlock> ]
[ ONMOUSEHOVER <
OnHoverProcedure> | <bBlock> ]
[ ONMOUSELEAVE <
OnLeaveProcedure> | <bBlock> ]
[ WIDTH <
nWidth> ]
[ HEIGHT <
nHeight> ]
[ AUTOSIZE ]
[ FONTNAME <
cFontName>
[ FONTSIZE <
nFontSize> ]
[ FONTBOLD < .T. | .F.> ]
[ FONTITALIC < .T. | .F.> ]
[ FONTUNDERLINE < .T. | .F.> ]
[ FONTSTRIKEOUT < .T. | .F.> ]
[ TOOLTIP <
cToolTipText> ]
[ BACKCOLOR <
anBackColor> ]
[ FONTCOLOR <
anFontColor> ]
[ BORDER < .T. | .F.> ]
[ CLIENTEDGE < .T. | .F.> ]
[ HSCROLL < .T. | .F.> ]
[ VSCROLL < .T. | .F.> ]
[ TRANSPARENT < .T. | .F.> ]
[ BLINK < .T. | .F.> ]
[ RIGHTALIGN < .T. | .F.> | CENTERALIGN < .T. | .F.> ]
[ VCENTERALIGN < .T. | .F.> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE < .T. | .F.> ]
[ NOPREFIX ]

END LABEL


DESCRIPTION:
nRow, nCol
Position in the area of ??the window in pixels.
nWidth, nHeight
The desired size of the Label control in pixels.
nId
The ID identifier this Control in Dialog Window
ControlName
A reference to the Label control
ParentWindowName
A reference to the Parent Window.
nHelpID
The help topic identifier for this Control
cValue
Specifies the Caption of the Label conrol
OnClickProcedure
An action to be performed when Clicking the control
OnHoverProcedure
An action to be performed when Mouse Hover over the control
OnLeaveProcedure
An action to be performed when Mouse Leave from over the control
cFontName
Specifies the Font Name
cFontSize
Specifies the Font Size
cToolTipText
Specifies the Text for the ToolTip
anBackColor
Specifies the Background Color
anFontColor
Specifies the Font Color
 
 
AUTOSIZE
Specifies to Auto size the control with the real length of the Label Value
BORDER
Specifies to draw border around the Label control
CLIENTEDGE
?
HSCROLL
?
VSCROLL
?
TRANSPARENT
Specifies that the background of a control should be transparent
BLINK
Specifies to set the Blink mode for the Label caption
RIGHTALIGN
Specifies to Right align the Label caption
CENTERALIGN
Specifies to Center align the Label caption
VCENTERALIGN
?
INVISIBLE
The visibility property specifies whether or not a control is visible


PROPERTIES:

·   Value
Set / Gets Label value.
·   Enabled
Set / Gets enabled state of a Label control
·   Visible
Set / Gets visible a Label control.
·   Row
Set / Gets row position of a Label control.
·   Col   
Set / Gets column position of a Label control.
·   Width
Set / Gets width of a Label control.
·   Height
Set / Gets height of a Label control.
·   Action
Set / Gets action of a Label control..
·   FontName
Set / Gets Label control's font name.
·   FontSize
Set / Gets Label control's font size.
·   FontBold
Set / Gets Label control's font bold property
·   FontItalic
Set / Gets Label control's font italic property
Set / Gets Label control's font underline property
Set / Gets Label control's font strikeout property
·   FontColor
Set / Gets the foreground color for text within the Label
·   BackColor
Set / Gets the background color for text within the Label
·   Alignment
Set / Gets the alignment for text within the Label
·   Cargo
Set / Gets user property 'Cargo' for Label control
·   Name (R)
Retrieves the name of a Label control.
·   Parent(D)
Set the name as character identifier of the parent window.
·   HelpId (D)
Set the numeric help topic identifier of the control.
·   AutoSize(D)
Control supports an autosizing of width
·   Blink
Sets the blink property for label control.

D: Available at control definition only
R: Read-Only

EVENTS:

·   OnClick/Action
Action to be performed when generic clicking of the control
Action to be performed when the mouse pointer hovers over the control
Action to be performed when the user moves the mouse pointer outside the boundaries of the control


METHODS:

·   Show
Shows a Label control
·   Hide
Hides a Label control
·   Release
Releases a Label control from memory
·   Refresh
Repaint a Control
·   SaveAs
Save a Label control as BitMap file.

EXAMPLE:

See demo in :
\Samples\Basic\Label
\Samples\Basic\Label_2

and sample in Chapter :
Adding a Label