3. Dialog Library -turn page- 4. Window Library

Contents | Start

Reference List Dialog Library


Clear_Dialog [Box$,]Dialog_Id  
Box$ Has no meaning and may allways be omitted.
Dialog_Id Dialog identification number.
Delete dialog box.
 
 
Clear_Parameter Dialog_Id
Dialog_Id Dialog identification number.
Clear all buttons and texts within a dialog box.
 
 
Def_Dialog R Dialog_Id[,X,Y,W,H],Title$,Type
Dialog_Id Dialog identification number.
X X-position of the upper left corner of the dialog box.
Y Y-position of the upper left corner of the dialog box.
W Width of the dialog box.
H Height of the dialog box.
Title$ Title of the dialog box.
Type Dialog box type.

Type=0: Non-moveable, modal dialog box.
Type=1: Moveable, modal dialog box.
Type=2: Moveable, non-modal dialog box.
Starts definition of a dialog box. Do not use Make_Dialog but rather the procedure Def_Dialog available starting with EasyGem 4.0, because this one does not contain any superfluous parameters and the Dialog_Id is returned already during the start of the definition. Moreover, you can determine the position and size of the dialog box at the same time.

Note:Dialog boxes are managed by EasyGem the same way as windows. This means you can apply the functions of the Window Library to dialog boxes as well by using the dialog identification number the same as a window identification number. For example, you can change the dialog box size and position during runtime using Win_Setborder.
 
 
Dialog_Button%F(Line_No,Object_No,Dialog_Id)
Line_No Line number within the dialog box.
Object_No Object number within the line.
Dialog_Id Dialog identification number.
This is a global flag-field which contains the information about the status of the buttons.
 
 
Dialog_Text$(Line_No[,Object_No],Dialog_Id)
Line_No Line number within the dialog box.
Object_No Object number within the line.
Dialog_Id Dialog identification number.
This is a global string field which contains the texts of all lines. EasyGem 4.0 offers the option of defining more than one input field per line. The input text for this field can then be taken from the three-dimensional variation.
 
 
D_Button Line_No,Txt$
Line_No Line number within the dialog box.
Txt$ Text of the button.
Define normal buttons.
 
 
D_Checkbox Line_No,Txt$  
Line_No Line number within the dialog box.
Txt$ Text of the checkbox.
Define checkboxes.
 
 
D_Disable Dialog_Id,Line_No,Object_No
Dialog_Id Dialog identification number.
Line_No Line number within the dialog box.
Object_No Object number within the line.
Disables an object (nonselectable). All objects can be selected at first, after a dialog box has been defined. If you would like to render certain objects nonselectable, you may use this command.
 
 
D_Edit Dialog_Id[,R Objekt_No[,R Line_No]]  
Dialog_Id Dialog identification number.
Objekt_No Object number within the line.
Line_No Line number within the dialog box.
Display and edit dialog box.
 
 
D_Edit_ Dialog_Id[,R Objekt_No[,R Zeile]]
Dialog_Id Dialog identification number.
Objekt_No Object number within the line.
Line_No Line number within the dialog box.
Edit dialog box.
 
 
D_Empty Line_No  
Line_No Line number within the dialog box.
Define an empty line in dialog box.
 
 
D_Enable Dialog_Id,Line_No,Object_No
Dialog_Id Dialog identification number.
Line_No Line number within the dialog box.
Object_No Object number within the line.
Enables an object (selectable). All objects are selected at first, after a dialog box has been defined. Objects deactivated with D_Disable can be reactivated using this command.
 
 
D_Event Dialog_Id,R Object_No[,R Line_No[,R Entry]]
Dialog_Id Dialog identification number.
Object_No Object number within the line.
Line_No Line number within the dialog box.
Entry Number of the menu item.
Evaluates an event. EasyGem 4.0 now offers this command with a fourth parameter, which makes it possible to evaluate menu items as well (e.g., cut, paste, copy,...) while a modal dialog box is open.
 
 
D_Exitbutton Line_No,Txt$[,Defbutton]
Line_No Line number within the dialog box.
Txt$ Text of the exit button.
Defbutton Object number of the button which can also be triggered by pressing the [Return] key.
Define exit button.
 
 
D_Getspace R Width, R Height
Width Horizontal distance between the objects.
Height Vertical distance between the objects.
Use this to query the current settings of the spaces.
 
 
D_Hide Dialog_Id  
Dialog_Id   Dialog identification number.
Remove dialog box from the screen.
 
 
D_Input Line_No,Txt$[,Input_Len[,Flag]]
Line_No Line number within the dialog box.
Txt$ Text before the actual input field with the variation featuring 3 or 4 parameters.
Starting with version 4.0, EasyGem offers a version of this command with 2 parameters. In this case you have to use
Txt$ to pass a control string as with D_Button. This makes it possible to define more than one input field per line.
Input_Len Length of the input field in letters.
Flag May always be omitted.
Defines an input line.
The field
Dialog_Text$(Line_No[,Object_No],Dialog_Id)will list whatever the user has indicated.
 
 
D_Output Line_No,Txt$,Output_Len
Line_No Line number within the dialog box.
Txt$ Text within the output line.
Output_Len Lenght of the output line.
Define an output line.
 
 
D_Popup Line_No,Txt$,Popup_Id
Line_No Line number within the dialog box.
Txt$ Text before the button containing the pop-up menu.
Popup_Id Identification number of the pop-up menu. First, of course, the pop-up menu has to be defined with Def_Popup.
Defines a button with pop-up menu. Use the flag field Dialog_Button%F(Line_No,Object_No,Dialog_Id) to specify the default item before the call and determine the selected item after the call.
 
 
D_Radiobutton Line_No,Txt$  
Line_No Line number within the dialog box.
Txt$   Text of the radio button.
Define radio button.
 
 
D_Redraw Dialog_Id[,Line_No]
Dialog_Id Dialog identification number.
Line_No Line number within the dialog box.
Redraw the whole dialog box or only one line.
 
 
D_Setaction Dialog_Id,Line_No,Object_No,Act_Fun
Dialog_Id Dialog identification number.
Line_No Line number within the dialog box.
Object_No Object number within the line.
Act_Fun Address of an action function. Three parameters are passed to the function. The function has to be a long integer type and defined as follows:

DEF FN My_Action(Dialog_Id,Line_No,Object_No)

Act_Fun=&FN My_Action(,,)
Sets the action function of an object. After the definition, all action functions are initially set to 0. For example, if you would like that a certain operation is executed immediately upon clicking on a button (even before exiting the dialog box with [OK]), you ca use this command to define an individual action function for each object. The function is called as soon as the user releases the mouse button over the selected object.
 
 
D_Setcellwidth Width
Width Width of a cell.
EasyGem assumes a fixed number of pixels for each input text character to set the horizontal position of an object. The default setting is 7 pixels. A higher value would lead to a horizontal distention of the individual objects. The texts themselves would not become wider but the buttons, for example, would.
The object height cannot be changed. EasyGem automatically adapts the height to fit the respective object type.
If you want to change the cell width, you have to do this before defining the dialog box, because only the subsequent commands are always affected.
 
 
D_Setspace Width, Height
Width Horizontal distance between the objects.
Height Vertical distance between the objects.
Use this command to influence the layout of dialog boxes. The command has to be executed before defining the dialog box, because only the subsequent commands are always affected. The default setting is 8 pixels for Width and 4 pixels for Height.
 
 
D_Show [Box$,]Dialog_Id
D_Show Dialog_Id,X,Y
Box$ Has no meaning.
Dialog_Id   Dialog identification number.
X X-position of the upper left corner.
Y Y-position of the upper left corner.
Display dialog box.
 
 
D_Text Line_No,Txt$
Line_No Line number within the dialog box.
Txt$ Text within the line.
Define a text line in the dialog box.
 
 
D_Title [Line_No,]Txt$
Line_No Line number within the dialog box.
Txt$ Text of the title bar.
Define a title bar in the dialog box.
 
 
Easy_Dialog Dialog_Id
Easy_Dialog
Box$,Dialog_Id[,R Object_No[,R Line_No]]
Easy_Dialog Dialog_Id,X,Y,R Object_No,R Line_No]]
Box$ Has no significans but has allways to be included.
Dialog_Id Dialog identification number.
X X-position of the left upper corner.
Y Y-position of the left upper corner.
Object_No Object number within the line.
Line_No Line number within the dialog box.
Display the dialog box and manage all events.
 
 
End_Dialog [Box$,]R Dialog_Id  
Box$ Has no significance and can allways be omitted.
Dialog_Id Dialog identification number.
Concludes dialog box definition. If you have started the definition with Def_Dialog, you should always use the version without parameters, because the dialog identification number has already been returned with Def_Dialog.
 
 
FN D_Controlid(Dialog_Id,Line_No,Object_No)
Dialog_Id Dialog identification number.
Line_No Line number within the dialog box.
Object_No Object number within the line.
The Dialog Library uses the Control Library to define and manage the objects. You can thus use this function to ascertain the control identification number for a specific object. This makes it possible to apply the functions of the Control Library to the individual objects of a dialog box (e.g., change the position with Con_Setborder).
 
 
FN D_Getcellwidth
Returns the width of a cell, which EasyGem uses for the dialog box layout.
 
 
FN Rbutton(Line_No,Dialog_Id)
Line_No Line number within the dialog box.
Dialog_Id Dialog identification number.
Determine number of pressed radio button.
 
 
Make_Dialog Type
Make_Dialog Box$,Dialog_Id[,Name$]
Type Dialog box type.

Type=0: Non-moveable, modal dialog box.
Type=1: Moveable, modal dialog box.
Type=2: Moveable, non-modal dialog box.
Box$ Has no meaning.
Dialog_Id Dialog identification number.
Name$ Has no meaning.
Start definition of a dialog box. Because only Type has a meaning it is recommended to use only the first variation of this command.
 
 

3. Dialog Library -turn page- 4. Window Library

Contents | Start



© 1998-2000 Berkhan-Software
www.berkhan.com | Home