| control | effect ( √ is MatrixExplorer supported) | most useful modifiers |
| √ rectangle with text, causes action when clicked | CALLback, ReturnCode |
| | - √ for a num argument its symbolic name is prefixed ( ⇒ example)
- positions are as for the other controls (unlike Align)
| , , |
| positions a text of arbitrary length to the right of previous control (Text=txt is shown with DefWidth) | Line |
| | √ text or number for display and change | DNum, Height, ReadOnly, Width, WRap |
| | prefixes an Edit control with its symbolic name (1 DefWidth) | Line |
| select from a list of texts | SelIdx, SelTxt, Height |
| combines Edit and ListBox: enter new text or select and edit | SelIdx, SelTxt, Height |
| √ square with text, toggled 0/1 when clicked | BiTteXt |
| circle with text, other circles unselected when clicked | BiTteXt |
| √ partially paints a rectangle | MAx, MIn, Vertical, Width |
| √ arrow in a bar to be moved with mouse or arrow keys. Shows tooltip window with num value scaled to 0...100 when mouse is clicked on the thumb | MAx, MIn, Vertical, Width |
| √ updown with thumb | MAx, MIn, Vertical, Width |
| √ stand-alone very short scroll bar without thumb | |
| group the following controls | with a frame title of txt. Either the last control or an explicit terminate the group |
| filled rectangle, default is BLAck | , , |
| unfilled rectangle, default is BLAck | BLAck, GRAY, WHIte |
: - the following buttons close a (the program waits until the dialog is closed
| |
| - rc is set to itemnr+1000 (here == 1001)
- : script waits until button (or ESCape) is hit
|
- rc = DLG(B="5:action 1", B="23:action 2")
| : rc is set to 5 or 23 for the buttons "action 1" or "action 2" resp. |
- rc = DLG(B="1:!", B="2:i", B="3:X", B="4:?")
| can be used instead of texts |
| - "&OK" is the default button
- & defines a , here the key "O" will close the dialog
|
| a "0:" prefix to (same as ESCape) |
| : the button displays a bitmap file in its full size |
| increase button height, line wrap button text |
- DLG(B=">123:name") ! or:
- DLG(B="jump", =123)
| : jump to label 123 of current procedure. If not found continue with next statement. |
- DLG(B="chapter5:show &5", B="chapter6:show &6")
| |
| to continue execution in single steps |
| to continue execution |
- DLG(B="$Print:print this dialog")
| open |
- DLG(B="http://www.anyname.xyz")
| to URL = www.anyname.xyz |
- DLG(B="shell:c:\HicEst\Web\faq.htm")
| |
- DLG(B="mailto:info@xyz.com ?subject=hello &&BODY=something important")
| open (no send) with- mail address ("info@xyz.com")
- subject (hello)
- text body (something important)
|
- DLG(HelpFile="HicEst.hlp", B="DLG.Button:&show")
| A "show" button. When hit, Appendix item of current HelpFile opens (here DLG.button) |
A includes the =handle option: - DLG(B="5:KEEP", =rtn, WINdowhandle=handle)
| - a modeless dialog stays on the screen while the script continues running. It is closed when button is hit, or a DLG(KiLl=handle) is executed
|
- , the DLG(Edit=argument) can be numerical or textual:
| Without a Button the explicit return value (e.g. "rc") of the DLG function is itemnr+1000 (here == 1001), else it is the default-button ID |
| is via ESCape or Cntl+Z |
| MatrixExplorer is called when the argument to Edit is a numerical array |
- DLG(Edit=num, DNum=delta)
⇒ see example | numeric edit with a spinner (2 small arrows): - delta <= 0 or absent: num changes by +- 1
- > 0: num changes +- 1 in its n-th significant digit
|
- DLG(E="text is too long but may be scrolled")
| text that is too long for the default width can be horizontally scrolled |
| - change height (0.999 --> )
- enable
- change width (to 5 DefWidth)
- a standard button is recommended to close the dialog
|
- DLG(E=num_or_txt, RightAlign)
| as for the Text-option CenterAlign and LeftAlign are also possible |
| ↵ on edit control will not close DLG. Useful to |
| input appears as *** |
| input is rejected, sometimes preferable to Text option |
| and | |
- DLG(ComBobox=names, =si, =string)
- DLG(ListBox=names, SelIdx=si, SelTxt=string)
⇒ see example | - si selects the initial index
- si receives the selected index. si == 0 when some new text is entered
- string gets the selected or the newly entered text
- without the Height option:
- combobox shows edit area only without dropdown list
- listbox shows maximum height possible
|
- DLG(ComBobox=names, Width=0)
- DLG(ListBox=names, Width=0)
| Width=0 adjusts the width to the maximum length of a line |
- DLG(ComBobox=names, Height=3, B="&OK", Line)
| - with the Height option a combobox shows a dropdown list only when another control follows below it
|
| : SOrt with log /= 0. SelIdx=si will have the sorted index |
| if "Tutorial.hic" is a valid file name, the file will be listed. |
if the listbox or combobox argument is not a valid file name: - DLG(ListBox="xyz")
- DLG(="Tutorial.hic", ListBox="SUBROUTINE DLGchild()", Width=6)
| - lists start with the 1st occurrence of the listbox or combobox argument in column 1 of the
- HelpFile argument
- current script file without HelpFile option
- the list is terminated with the next line that has a non-blank in column 1
|
if above fails: - DLG(combo="duck,dog,donkey,")
| "duck,dog,donkey," is a string with non-alfanumeric characters as separators |
| to open a HicEst help window for "topic" from the script |
| |
- DLG(Edit=num,MIn=min,MAx=max,DNum=dn, ProgressBar=num,MIn=min,MAx=max,DNum=dn, TrackBar=num,MIn=min,MAx=max,DNum=dn, ScrollBar=num,MIn=min,MAx=max,DNum=dn, UpDown=num,MIn=min,MAx=max,DNum=dn, TItle="Edit, Progress, Track, Scroll, UpDown", UPDAte)
- is possible after ScrollBar, ProgressBar, TrackBar
|
| option | type | (missing [num] evaluates to o | default setting |
| num | set lower bound of a numerical control | -1E300 |
| num | MAx=max sets the upper bound of a numerical control | 1E300 |
| [num] | DNum = dn sets the step size of a numerical control- TrackBar, ScrollBar, UpDown: page up/down keys
- TrackBar: scale tic difference
- Edit ⇒ DNum details
| 0 |
| --- | to repaint the dialog when a control modified its argument value | --- |
| | | : modify all subsequent controls of this DLG statement | W, H= dialog font width, height |
| [num] | spacing between box edges and controls | 1.75 * W |
| num | default height DH of controls | 1.5 * H |
| num | default width DW of controls | 10 * W |
| [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
|
| num | height of control | 1 * DH |
| num | width of control | 1 * DW |
| [num] | x-position of control left border: X=0 or simply X | 1 * SPace right of preceding control |
| [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
|
| [num] | add to current Y and reset X to 0 | 1 * DH |
| | remember X and Y of next control | --- |
| [num] | add to X of preceding SetMemory, use instead X | 0 |
| [num] | add to Y of preceding SetMemory, use instead Y | 0 |
| num | horizontal position of dialog (> 1: script font character widths) | script window right aligned |
| num | vertical position of dialog (> 1:script font character heights) | script window center aligned |
| | | | |
| 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 | |
| --- | preceding control gets initial focus | 1st control |
| --- | preceding Button becomes default ↵ regardless of actual focus | "&OK" is always DEFault |
| log | 0 to disable (gray-out) and 1 to enable preceding control | 1 (enabled) |
| log | 0 to hide and 1 to show preceding control | 1 (show) |
| num | foreground ⇒ color of preceding control | 0 (black) |
| num | background ⇒ color of - preceding control
- of DLG window if prefixed to 1st control
| 11 (bright cyan) |
| | | | |
| n/c | | HicEst Menu → Options → Fonts →3 |
| num | font size for this DLG | |
| --- | use fixed font for this DLG | |
| | | | |
| txt | title caption ⇒ example. To have a DLG with set txt=" " | "..." |
| NUM | - DLG(KiLl=otherhandle, ...)
close a DLG or WINDOW with handle == otherhandle | --- |
| 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 |
| --- | - 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 |
| 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 "|" | " :=*;>-|" |