| |
GUI
Display |
| |
|
| Format |
'DIALOGUE'
(col,ln,wth,ht[,wdw_id],[title$][,attrib$][,OPT=string$]) Where:
| col,ln, |
Position / coordinates. Numeric
expressions. Column and line |
| wth,ht |
coordinates for top left corner,
width in number of columns and height in number
of lines. |
| attrib$ |
Optional attribute string. If you
include attributes, use one or more mnemonics to
define the defaults for the window. String
expression. |
| title$ |
Optional title. String expression. |
| string$ |
Optional attributes. Supported
options include:
| Attr. |
Description |
| & |
Ampersand - creates window
that logically attaches to the current
window (i.e., leaves the current window
active and shares controls) |
| * |
Asterisk - creates resizable
window with automatic scrollbars for text
plane; e.g., PRINT
'DIALOGUE'(1,1,60,20,"Title",OPT="*") |
| - |
Dash/Minus Sign - window has
a minimize button. |
| ? |
Window supports Win95 Help
button. |
| ^ |
Caret - window is always on
top (not applicable to the 'WINDOW'
mnemonic); e.g., PRINT
'DIALOGUE'(1,2,30,3,"My Top
Dog",OPT="^"). |
| c |
Window is a child of the
current window. |
| C |
Disables X close
button on title bar of window and
eliminates the system control menu from
the title bar. |
| F |
Window can be maximized,
occupying full screen (regardless of
number of columns/rows). Area outside the
defined text region will be cleared to
the default background colour for the
window. |
| h |
Window has no title bar. |
| i |
Window has no icon in the
upper left corner. |
| m |
Enables "maximize"
box in top right corner of window (only
for dialogue windows created with
OPT="*"). |
| M |
Window has a menu bar. |
| s |
'DIALOGUE'( ) returns
a CTL value to signal when the dialogue
view state is changed; i.e.,
| CTL |
Change of
state |
| CTL=-1106 |
when the dialogue is
minimized |
| CTL=-1107 |
when the dialogue is
restored to normal state |
| CTL=-1105 |
when the dialogue is
maximized.
(also returned for the Z option
(below) if dialogue has been
resized.) |
|
| S |
Window has Status line /
Message Bar. |
| x |
Disables X close
button on title bar of window and
eliminates the system control menu from
the title bar. |
| X |
Enables X close
button on title bar of window and
supports the system control menu on the
title bar. |
| Z |
Creates a resizable window.
When the user resizes the window
aCTL=-1105 is generated. |
|
| wdw_id |
Optional dialogue window's unique ID
number (0 -255). |
|
| |
|
| Description |
Use
'DIALOGUE' to define a new window which
is not contained in the main ProvideX screen. In a
non-Windows environment, this does the same as a Window OPT="string_of_characters"
mnemonic. |
|
|
| *Note* |
The
‘DIALOGUE' mnemonic with
OPT="^"can be useful for error message windows.
Although the users can still perform other operations,
the error message will remain “lways on Top” as
a constant reminder to deal with the error. |
|
|
| |
ProvideX
uses the WS_DLGFRAME frame style from the Windows API for
the 'DIALOGUE' mnemonic. For more information, see Windows
API Frame Styles. See also: 'TEXTWDW'
Create Text Window and WINDOW' Define / Draw
Window.
|
| |
|
| Example |
The
example below creates a dynamic, resizable/scrollable
viewer using a ‘DIALOGUE'
window which is large enough to display the complete
picture. A 'SIZE' mnemonic fits the
window to the screen. The user is supplied with scroll
bars to view the desired image.
0010 CALL
"*picture;Get_size","c:\windows\clouds.bmp",WD,HI
0020 LET
WD=INT(WD),HI=INT(HI)
0030 PRINT
'DIALOGUE'(10,10,WD,HI,"MY
Photo",OPT="*-m"),
0030:
'SIZE'(30,10),'B?','SR','CS',
(ProvideX normally
redraws the text plane below the picture. Line 0040
suppresses the text plane to avoid flicker.)
0040 PRINT '-T',
0050 PRINT
'PICTURE'(0,0,@X(WD),@Y(HI),"C:\windows\clouds.bmp"),
0060 OBTAIN 'C0',*; IF
CTL<>4 THEN GOTO *SAME
|