option |
type |
(missing [num] evaluates to o |
default setting |
MIn , MAx |
num |
set lower and upper bound of numerical controls
- TrackBar -32768...32767
- ScrollBar: 0...65535
- ProgressBar: 0...32767
- UpDown: 0...32767
- Edit
⇾ Edit details
|
0...100 |
DNum |
[num] |
DNum = dn sets the step size of a numerical control
- TrackBar, ScrollBar, UpDown: page up/down keys
- TrackBar: scale tic difference
- Edit
⇾ Edit details
|
0 |
UPDAte |
--- |
to repaint the dialog when a control modified its argument value |
--- |
|
|
: modify all subsequent controls of this DLG statement |
W=dialog font width, H=height |
BORder |
[num] |
spacing between box edges and controls |
1.75 * W |
DefHeight |
num |
default height DH of controls |
1.5 * H |
DefWidth |
num |
default width DW of controls |
10 * W |
SPace |
[num] |
spacing between controls |
W |
|
|
by modifying default position of preceding control
- num ≥ 1: multiples of DW or DH
- num < 0: multiples of W or H
- 0.01...0.999: screen portions
- if missing: same as num=0
|
default values:
- DH = current DefHeight
- DW = current DefWidth
- H = character height
- W = character width
|
Height |
num |
height of control |
1 * DH |
Width |
num |
width of control |
1 * DW |
X |
[num] |
x-position of control
left border: X=0 or simply X |
1 * SPace right of preceding control |
Y |
[num] |
y-position of control
top border: Y=0 or simply Y |
if for preceding control
- default H: Y unchanged
- H set: 1 SPace below preceding control
|
Line |
[num] |
add to current Y and reset X to 0 |
1 * DH |
SetMemory |
|
remember X and Y of next control |
--- |
XMemoryadd |
[num] |
add to X of preceding SetMemory, use instead X |
0 |
YMemoryadd |
[num] |
add to Y of preceding SetMemory, use instead Y |
0 |
X0 |
num |
horizontal position of dialog (> 1: script font character widths) |
script window right aligned |
Y0 |
num |
vertical position of dialog (> 1:script font character heights) |
script window center aligned |
|
|
|
|
CALLback |
SUB |
- call SUB after ↵ on Button, numeric Edit, TrackBar, ScrollBar
- CALLback is inherited by all subsequent items
- use
ReturnCode to tell which item caused SUB to be invoked
- controls can be postfixed by different CALLback options to call different SUBs
- CALLback=' ' will cancel callbacks following the preceding control
|
no default |
|
|
to a particular control |
|
FocuS |
--- |
preceding control gets initial focus |
1st control |
DEFault |
--- |
preceding Button becomes default ↵ regardless of actual focus |
"&OK" is always DEFault |
EnAble |
log |
0 to disable (gray-out) and 1 to enable preceding control |
1 (enabled) |
SHOW |
log |
0 to hide and 1 to show preceding control |
1 (show) |
ForeColor |
num |
foreground
⇾ color of preceding control |
0 (black) |
BaCkcolor |
num |
background
⇾ color of
- preceding control
- of DLG window if prefixed to 1st control
|
11 (bright cyan) |
|
|
|
|
FONt |
n/c |
|
or set in
HicEst Menu → Options →
Fonts →3 |
PoinT |
num |
font size for this DLG |
|
FixedFont |
--- |
use fixed font for this DLG |
|
|
|
|
|
TItle |
txt |
title caption
⇾ example. To have a DLG with set txt=" " |
"..." |
CHanGed |
NUM |
Gets the sum of 2^itemNR of changed Edit, TrackBar, ScrollBar, UpDown controls
- DLG(E=x, NameE=y, TrackB=z, ID=tbID, CHanGed=chg)
- in this example: itemNR=1 for x, =3 for y (Name counted also), =4 for z
- if y is edited AND z changed by the trackbar, chg is set to 2^3 + 2^4 = 24
|
|
KiLl |
NUM |
- DLG(KiLl=otherhandle, ...)
close a DLG or
WINDOW with handle == otherhandle |
--- |
Owner |
NUM |
- DLG(..., WINdowhandle=win2, Owner=win1)
- create modeless dialog with handle win2
- with Owner=win1 the new window win2 will always be in front of the owner window win1.
- If not specified, or if specified as constant 0, then the new window can be overlapped by any window in your program.
- Owned dialogs or windows are closed when the owner is closed
|
Main window |
CHIld |
--- |
- DLG(..., WINdowhandle=win2, CHIld, Owner=win1)
Creates a child dialog box. When used with a modeless dialog box, the dialog box will maintain its position relative to the owner window. |
not a child |
SEParators |
txt |
to replace the default separators (
⇾ alternate syntax DLG only) enter txt as a 8-byte replacement string for (1) Space " ", (2) Colon ":", (3) Equals "=", (4) Asterisk "*", (5) Semicolon ";", (6) Goto ">", (-) Minus "-", (8) newline "|" |
|