@...PROGRESSBAR
DEFINE PROGRESSBAR
Create a ProgressBar control
  

Creates a progressbar control.

SYNTAX

Standard Window:

@ <nRow> ,<nCol> PROGRESSBAR <ControlName>
[ ID <
nId> ]
[ OF | PARENT | DIALOG <
ParentWindowName> ]
[ RANGE <
nRangeMin> , <nRangeMax> ]
[ VALUE <
nValue> ]
[ WIDTH <
nWidth> ]
[ HEIGHT <
nHeight> ]
[ TOOLTIP <
cToolTipText> ]
[ VERTICAL ]
[ SMOOTH ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]
[ BACKCOLOR <
anBackColor> ]
[ FORECOLOR <
anForeColor> ]
[ STYLE ] [ MARQUEE  [ VELOCITY <
nVelocity> ]

Dialog Window:

REDEFINE PROGRESSBAR <ControlName>
ID <
nId>
[ OF | PARENT | DIALOG <
ParentWindowName> ]
[ RANGE <
nRangeMin> , <nRangeMax> ]
[ VALUE <
nValue> ]
[ TOOLTIP <
cToolTipText> ]
[ VERTICAL ]
[ SMOOTH ]
[ HELPID <
nHelpId> ]
[ INVISIBLE ]
[ BACKCOLOR <
anBackColor> ]
[ FORECOLOR <
anForeColor> ]

Alternate Syntax:

DEFINE PROGRESSBAR

[ ID <nId> ]
[ PARENT <
ParentWindowName> ]
COL <
nCol>
ROW <
nRow>
[ RANGEMIN <
nRangeMin> ]
[ RANGEMAX <
nRangeMax> ]
[ VALUE <
nValue> ]
[ WIDTH <
nWidth> ]
[ HEIGHT <
nHeight> ]
[ TOOLTIP <
cToolTipText> ]
[ VERTICAL < .T. | .F.> ]
[ SMOOTH < .T. | .F.> ]
[ HELPID <
nHelpId> ]
[ INVISIBLE < .T. | .F.> ]
[ BACKCOLOR <
anBackColor> ]
[ FORECOLOR <
anForeColor> ].
[ MARQUEE . < .T. | .F.> ]
[ VELOCITY <
nVelocity> ]

END PROGRESSBAR

Remarks

The minimum value in the range can be from 0 to 65,535. Likewise, the maximum value can be from 0 to 65,535
Note: SMOOTH, BACKCOLOR & FORECOLOR has no effect when XP-Style is used.


DESCRIPTION:
nRow, nCol
Position in the area of ??the window in pixels.
nWidth, nHeight
The desired size of the ProgressBar Control in pixels.
nId
The ID identifier this Control in Dialog Window
ControlName
A reference to the ProgressBar Control
ParentWindowName
A reference to the Parent Window.
nHelpID
The help topic identifier for this Control
nRangeMin, nRangeMax
Specifies the range of value for the progressBar
cToolTipText
Specifies the Text for the ToolTip
anBackColor
Specifies the Background Color
anForeColor
Specifies the Font Color
nVelocity
Specifies the speed velocity of the ProgressBar control
 
 
VERTICAL
specifies that the ProgressBar control is vertical from bottom to top
SMOOTH
Specifies that the visual update of the ProgressBar is smooth
INVISIBLE
The visibility property specifies whether or not a control is visible


PROPERTIES:

·   Value
Set / Gets ProgressBar value.
·   Enabled
Set / Gets enabled state of a ProgressBar control
·   Visible
Set / Gets visible a ProgressBar control.
·   Row
Set / Gets row position of a ProgressBar control.
·   Col
Set / Gets column position of a ProgressBar control.
·   Width
Set / Gets width of a ProgressBar control.
·   RangeMax
Set / Gets range max of a ProgressBar control.
·   RangeMin
Set / Gets range min of a ProgressBar control..
·   ForeColor
Set / Gets the he forecolor for ProgressBar control
·   BackColor
Set / Gets the background color for text within the ProgressBar
·   Cargo
Set / Gets user property 'Cargo' for ProgressBar control
·   Name (R)
Retrieves the name of a ProgressBar control.
·   Parent(D)
Set the name as character identifier of the parent window.
·   HelpId (D)
Set the numeric help topic identifier of the ProgressBar .
·   Vertical(D)
Sets the value to create Vertical ProgressBar.
·   Smooth (D)
Sets value to create a smooth, scrolling ProgressBar control

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

METHODS:

·   Show
Shows a ProgressBar control
·   Hide
Hides a ProgressBar control
·   Redraw
Redraw a Control
·   Release
Releases a ProgressBar control from memory
·   SaveAs
Save a ProgressBar control as BitMap file.

EXAMPLE:

See sample in Chapter:
Showing Progress