| |
Graphical
control objects are used in ProvideX applications to
display information, input data, and handle event
processing. These controls can be created using specific
directives or designed/produced in NOMADS, the ProvideX
GUI-based application development system. Refer to the ProvideX
NOMADS Reference for further information. The following control
object types are supported in ProvideX:
This
section provides cross-references to corresponding
directives and lists all of the properties used to define
and manipulate each of the specific object types. The
list supplied immediately below each object heading is
linked to descriptions under the full Properties List.
Properties that define extended
attributes are shown in italics.
They represent a category of attributes that cannot be
accessed within a directive (via FMT= or
OPT=); e.g., the majority of cell
attributes in the grid are defined/set
using properties. See also Compound Properties.
|
|
|
| BUTTON
|
A
button object is usually designed to send a signal to the
application when selected by a mouse click. The signal
typically indicates that the user wants to end a function
or initiate a new function. For more information on BUTTON controls, refer
to the BUTTON Directive.
| BackColour$ |
| BitmapPosition |
| Col |
| Cols |
| CtlName$ |
| Cursor |
| Enabled |
| Eom$ |
| Focus |
|
| Font$ |
| Height |
| HoverColour$ |
| hWnd |
| ImageCount |
| Key$ |
| Left |
| Line |
| Lines |
|
| MaxValue (sizer) |
| MenuCtl |
| MinValue (sizer) |
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SignalOnly |
|
| Text$ |
| TextColour$ |
| Tip$ |
| Top |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| CHART
|
The
chart control is used to create illustrations for an
application. A chart is usually designed to be a display
only object that requires no user
interaction. For more information on this control, refer
to the CHART Directive.
| BackColour$ |
| Col |
| Cols |
| CtlName$ |
| CurrentPoint |
| CurrentSet |
| Enabled |
| Eom$ |
| Fmt$ |
| Font$ |
| Footer$ |
|
| Height |
| hWnd |
| Left |
| LegendLocation$ |
| LegendText$ |
| Line |
| Lines |
| MenuCtl |
| NumPoints |
| NumSets |
| ObjectID |
|
| Parent |
| PointText$ |
| SelectIndex |
| Sep$ |
| SepLoad$ |
| TextColour$ |
| Tip$ |
| Title1$ |
| Title2$ |
| Top |
| Value$ |
|
| Visible |
| Width |
| XAxisLocation$ |
| XAxisTitle$ |
| YAxisLocation$ |
| YAxisTitle$ |
| ZAxisLocation$ |
| ZAxisTitle$ |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| CHECK_BOX |
A
check box object is designed to be toggled between two
states: ON to check the option
or OFF to uncheck it. For more
information on the CHECK_BOX control, refer to the CHECK_BOX Directive.
| BackColour$ |
| BitmapPosition |
| Col |
| Cols |
| CtlName$ |
| Cursor |
| Enabled |
| Eom$ |
| Focus |
|
| Font$ |
| Height |
| HoverColour$ |
| hWnd |
| ImageCount |
| Key$ |
| Left |
| Line |
| Lines |
|
| MenuCtl |
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SignalOnly |
| Tbl$ |
| Text$ |
|
| TextColour$ |
| Tip$ |
| Top |
| Value$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| DROP_BOX
|
This
control is used to provide a dropdown list of elements
from which users can make a selection. A drop box takes a
smaller amount of space on the screen than a comparable
list box. For more information on this control, refer to
the DROP_BOX Directive.
| Auto |
| BackColour$ |
| Col |
| Cols |
| CtlName$ |
| CurrentItem |
| DisableOnEmpty |
| DroppedOn |
| Enabled |
| Eom$ |
| FindItemText$ |
|
| Focus |
| Font$ |
| Height |
| hWnd |
| Item |
| ItemCount |
| ItemText$ |
| Key$ |
| Left |
| Line |
| Lines |
|
| MenuCtl |
| Msg$ |
| ObjectID |
| OnDropOpenCtl |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| Sep$ |
| SepLoad$ |
| SignalOnExit |
| Tbl$ |
|
| TblWidth |
| TextColour$ |
| Tip$ |
| Top |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| GRID |
The
GRID control is used to create a table
of cells in columns and rows; i.e., a spreadsheet input
format. For more information, refer to the GRID Directive. See also Grid
Property Access, Multiple Selections,
Drag and Drop, and Loading/Accessing
by Row,
| Align$ |
| Auto |
| AutoSequence |
| AutoTrack |
| BackColour$ |
| Bitmap$ |
| BottomBorder |
| BottomLeftTick$ |
| CellFormat$ |
| CellHiLight |
| CellImpliedDecimal |
| CellLeft |
| CellTag$ |
| CellTbl$ |
| CellTblWidth |
| CellTip$ |
| CellTop |
| CellType$ |
| CellTypeList$ |
| Col |
| Cols |
| Column$ |
| ColumnNames$ |
| ColumnPixels |
| ColumnSizeLock |
| ColumnsWide |
| ColumnWidth |
| CtlName$ |
| CurrentCellColour$ |
|
| CurrentColno |
| CurrentColumn$ |
| CurrentRow |
| DraggedColumn$ |
| DraggedRow |
| DroppedOnColumn$ |
| DroppedOnRow |
| Enabled |
| EnterMode |
| Eom$ |
| ExcelStyle |
| FillColour$ |
| Fmt$ |
| Focus |
| Font$ |
| Height |
| hWnd |
| ImpliedDecimal |
| InsDelEnabled |
| JoinColumns |
| JoinRows |
| Key$ |
| Left |
| LeftBorder |
| Len |
| Line |
| Lines |
| LoadIOLIST$ |
| LoadList$ |
|
| Lock |
| LockColumns |
| LockRows |
| MenuColumn$ |
| MenuCtl |
| MenuRow |
| Msg$ |
| MultiSelect |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| OverlapEnabled |
| Parent |
| Resizable |
| RightBorder |
| Row |
| RowData$ |
| RowHeight |
| RowHiLight |
| RowPixels |
| RowsHigh |
| SelectColumn |
| SelectCount |
| SelectIndex |
| SelectRow |
| SelectText$ |
| SelectValue$ |
| Sep$ |
| SepLoad$ |
|
| SignalOnExit |
| SkipLockedCells |
| Sort |
| SortCaseSensititive |
| SortColFmt$ |
| SortGrouping |
| SortNullLast |
| SortOnHdrClick |
| SwapEnabled |
| TabMode |
| Text$ |
| TextColour$ |
| TickPerUnit |
| TickPixels |
| Tip$ |
| Top |
| TopBorder |
| TopLeftTick$ |
| TopVisibleRow |
| TrackColour$ |
| Uppercase |
| Value$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| LIST_BOX
|
A
list box displays a list of elements from which the users
can make a selection. ProvideX supports different list
box types: Standard and Formatted (see
the LIST_BOX Directive), LISTVIEW (described below), and TREEVIEW (described below).
See also Multiple Selections
and Load on Demand.
| Auto |
| BackColour$ |
| BackHilight1$ |
| BackHilight2$ |
| Col |
| Cols |
| CtlName$ |
| CurrentItem |
| DisableOnEmpty |
| DroppedOn |
| Enabled |
| Eom$ |
| FindItemText$ |
| Fmt$ |
|
| Focus |
| Font$ |
| Height |
| HoverColour$ |
| hWnd |
| Item |
| ItemCount |
| ItemNeededCtl |
| ItemNeededFrom |
| ItemNeededTo |
| ItemText$ |
| Key$ |
| Left |
| Line |
|
| Lines |
| MenuCtl |
| MouseOver |
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SelectCount |
| SelectIndex |
| SelectItem |
| Sep$ |
| SepLoad$ |
| SignalOnExit |
|
| Tbl$ |
| TblWidth |
| TextColour$ |
| Tip$ |
| Top |
| TopVisibleItem |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|
|
|
| LISTVIEW
|
This
control operates like a standard list box but provides
for columnar lists with optional bitmaps. The format
appears similar to the right-side pane of
“classic” Windows Explorer. Details on the
Listview control are provided under the LIST_BOX Directive. See
also Load on Demand, and Multiple
Selections.
| Auto |
| BackColour$ |
| BackHilight1$ |
| BackHilight2$ |
| Col |
| Cols |
| Column |
| ColumnClicked |
| ColumnHdrTip$ |
| CtlName$ |
| CurrentItem |
| DisableOnEmpty |
| DroppedOn |
| Enabled |
| Eom$ |
|
| ExcelStyle |
| FindItemText$ |
| Fmt$ |
| Focus |
| Font$ |
| Height |
| HoverColour$ |
| hWnd |
| Item |
| ItemCount |
| ItemNeededCtl |
| ItemNeededFrom |
| ItemNeededTo |
| ItemText$ |
| Key$ |
|
| Left |
| Line |
| Lines |
| MenuCtl |
| MouseOver |
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SelectCount |
| SelectIndex |
| SelectItem |
| Sep$ |
| SepLoad$ |
|
| SignalOnExit |
| Tbl$ |
| TblWidth |
| TextColour$ |
| Tip$ |
| Top |
| TopVisibleItem |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|
|
|
| MULTI_LINE
|
Multi-lines
provide a standard input field to display and enter one
or more lines of text. For more information on the MULTI_LINE control, refer to
the MULTI_LINE Directive.
| Auto |
| BackColour$ |
| Col |
| Cols |
| CtlName$ |
| Enabled |
| Eom$ |
| Fmt$ |
| Focus |
| Font$ |
| Height |
|
| hWnd |
| ImpliedDecimal |
| Key$ |
| Left |
| Len |
| Line |
| Lines |
| Lock |
| MenuCtl |
| Msg$ |
| Nul$ |
|
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| Scroll |
| SelectLength |
| SelectOffset |
| SelectText$ |
| Sep$ |
| SignalOnExit |
| TextColour$ |
|
| Tip$ |
| Top |
| Uppercase |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|
| |
|
| |
Rich
Text Format word processor controls have
the following additional control specific properties (see
RTF Multi-lines):
| FindText |
| SelAlign$ |
| SelBold |
| SelBulletno |
|
| SelBullets
|
| SelChooseFont |
| SelEmboss |
| SelFont$ |
|
| SelIndent |
| SelItalic |
| SelParaUndent |
| SelRightIndent |
|
| SelStrikeOut |
| SelTextColour$ |
| SelUnderscore |
| |
|
|
|
|
| RADIO_BUTTON |
Radio
buttons are used to control a variable between a series
of preset states, offering one choice from a group of
options. When one radio button is selected, it becomes
activated (on) and all other related radio buttons are
automatically reset (off). For more information on the RADIO_BUTTON control, refer to
the RADIO_BUTTON Directive
| BackColour$ |
| BitmapPosition |
| Col |
| Cols |
| CtlName$ |
| Cursor |
| Enabled |
| Eom$ |
| Focus |
| Font$ |
|
| Height |
| HoverColour$ |
| hWnd |
| Id |
| ImageCount |
| Key$ |
| Left |
| Line |
| Lines |
| MenuCtl |
|
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SignalOnly |
| Tbl$ |
| Text$ |
| TextColour$ |
| Tip$ |
|
| Top |
| Value$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
| |
| |
|
|
|
|
| TREEVIEW |
This
control operates like a standard list box but appears as
a tree-like structure with optional bitmaps. Each entry
in a tree view consists of a series of strings or values
separated by a delimiter like a directory structure.
Details on the Treeview list box control are provided
under the LIST_BOX Directive. See also State
Indicators and Multiple Selections.
| Auto |
| AutoState |
| BackColour$ |
| CascadeState |
| Children |
| Col |
| Cols |
| CtlName$ |
| CurrentItem |
| DroppedOn |
| Edit |
| Enabled |
| Eom$ |
| Expanded |
| FindItemText$ |
|
| Fmt$ |
| Focus |
| Font$ |
| Height |
| hWnd |
| Item |
| ItemCount |
| ItemState |
| ItemTag$ |
| ItemText$ |
| Key$ |
| Left |
| Line |
| LineColour$ |
| Lines |
|
| MenuCtl |
| MouseOver |
| Msg$ |
| NotifyExpand |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| PrefixData |
| SelectCount |
| SelectedChildren |
| SelectIndex |
| SelectItem |
| SelectStateMask |
| Sep$ |
|
| SepLoad$ |
| SignalOnExit |
| Sort |
| StateBitmaps$ |
| TextColour$ |
| Tip$ |
| Top |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|
|
|
| TRISTATE_BOX |
A
tristate box is a check box in which the user can toggle
between three states: ON, OFF, and a third choice. For
more information, refer to the TRISTATE_BOX Directive.
| BackColour$ |
| BitmapPosition |
| Col |
| Cols |
| CtlName$ |
| Cursor |
| Enabled |
| Eom$ |
| Focus |
|
| Font$ |
| Height |
| HoverColour$ |
| hWnd |
| ImageCount |
| Key$ |
| Left |
| Line |
| Lines |
|
| MenuCtl |
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| SignalOnly |
| Tbl$ |
| Text$ |
|
| TextColour$ |
| Tip$ |
| Top |
| Value$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
|
|
|
|
| VARDROP_BOX |
The
VARDROP_BOX control operates
like a standard drop box but will allow variable input.
That is, the user can select any element from a list of
items associated with the drop box but can also enter any
other value. For more information on this control, refer
to the VARDROP_BOX Directive.
| Auto |
| BackColour$ |
| Col |
| Cols |
| CtlName$ |
| CurrentItem |
| DroppedOn |
| Enabled |
| Eom$ |
| FindItemText$ |
| Focus |
|
| Font$ |
| Height |
| hWnd |
| Item |
| ItemCount |
| ItemText$ |
| Key$ |
| Left |
| Line |
| Lines |
| MenuCtl |
|
| Msg$ |
| ObjectID |
| OnDropOpenCtl |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| Sep$ |
| SepLoad$ |
| SignalOnExit |
| Tbl$ |
| TblWidth |
|
| TextColour$ |
| Tip$ |
| Top |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|
|
|
| VARLIST_BOX |
The
VARLIST_BOX control operates
like a standard list box but will allow variable input.
That is, the user can select any element from a list of
items associated with the list box but can also enter any
other value. For more information on this control, refer
to the VARLIST_BOX Directive.
| Auto |
| BackColour$ |
| Col |
| Cols |
| CtlName$ |
| CurrentItem |
| DroppedOn |
| Enabled |
| Eom$ |
| FindItemText$ |
| Focus |
|
| Font$ |
| Height |
| hWnd |
| Item |
| ItemCount |
| ItemText$ |
| Key$ |
| Left |
| Line |
| Lines |
| MenuCtl |
|
| Msg$ |
| ObjectID |
| OnFocusCtl |
| OnTipCtl |
| Parent |
| Sep$ |
| SepLoad$ |
| SignalOnExit |
| Tbl$ |
| TblWidth |
| TextColour$ |
|
| Tip$ |
| Top |
| Value$ |
| ValueNoSignal$ |
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
| |
|
|
|
|
| V_SCROLLBAR
and
H_SCROLLBAR |
The
V_SCROLLBAR and H_SCROLLBAR
controls are designed to create and manipulate vertical
and horizontal scrollbars on the screen. For more
information on this control, refer to the V_SCROLLBAR
Directive, and the H_SCROLLBAR Directive.
| Auto |
| BigJump |
| Col |
| Cols |
| CtlName$ |
| Enabled |
|
| Height |
| hWnd |
| Key$ |
| Left |
| Line |
| Lines |
|
| MaxValue |
| ObjectID |
| Parent |
| SmallJump |
| Top |
| Value$ |
|
| Visible |
| Width |
| _PropList$ |
| _PropSep$ |
| _PropValue$ |
| |
|
|