Specifications For User Defined Dialogs: Manual With Examples V 1.5

Specifications for
User Defined Dialogs
Manual with Examples v 1.5

1 Contents
1 Contents....................................................................... 2
2 Definition...................................................................... 3
2.1 Take Notice .................................................................................... 3
2.2 The Positions.................................................................................. 4
3 Creation of the file....................................................... 5
3.1 Dialogue Elements ......................................................................... 6
3.1.1 Edit Box .................................................................................................6
3.1.2 Lable ......................................................................................................9
3.1.3 Check Box ...........................................................................................10
3.1.4 Radion Buttons ....................................................................................11
3.1.5 Call of Subdialogs................................................................................13
3.1.6 Space...................................................................................................15
3.1.7 Edit Box for Values ..............................................................................15
3.1.8 Check Box with Special Output ...........................................................18
3.1.9 Radio Buttons with Special Output ......................................................20
3.1.10 List Box ...............................................................................................22
4 Example for a user defined file .............................. 34

4.1 So You Write Your UDL-File......................................................... 35
4.2 Example Dialogue Geo ................................................................ 37
4.3 Example Dialogue GeoSel ........................................................... 39
4.4 Example Dialogue StartAsk.......................................................... 40
4.5 Example Dialogue String .............................................................. 41
2 Definition
This description is a summary of all dialogue elements you have at your disposal in a user-
defined dialogue. In addition, at the end of the description, you will find a detailed example
for a user-defined dialogue. …
The file for the user-defined dialogue

! has a main section and
! can be composed of several field sections. The main section describes the
dialogue window. The field sections describe the different dialogue elements
and are always numbered.
2.1 Take Notice

If you use the user-defined dialogue for the input of variables, i.e. you want to create a UDL
file; you must consider the following:
! You always use only a UDL file.

! You must give a special name to the main section and the field sections so that
the names of the sections are composed as follows.
Special designation: Geo

• Main Section = Special name + _ + Main = [Geo_Main]
• Field Section = Special name + _ + Field# + LaufVar = [Geo_Field#1]
! In a UDL file, you can define several dialogs. Each dialogue obtains another
designation.
2.2 The Positions
PosY
PosX
3 Creation of the file
Main Section Type Max
[Main] Name Dialogue Heading Text 80
NoOfFields Number of dialogue elements ( Number 999

Field#XXX )
Help Call the Notepad to view help texts Number 0/1

No Help 0
Helpfile Path und file name of the help file Text FS
LastValue Pre-define the dialogue elements with Number

values.
No pre-defining of dialogue elements.
0
Use the default values of the UDL-file
1
If no values exist in the INI file, the
default values of the output file will be
used.
Only the values of the output file will be
used.
PosX Position of window in X direction from Number Int2

left margin of the screen.
(-1 = center on screen)
PosY Position of window in Y direction from Number Int2

upper margin of screen.
(-1 = center on screen)
FS = Number of characters for Path and File Name.
Field Section Type Max
[Field#001] The volumes of the field sections depend on the used dialogue
elements.
•••
[Field#XXX
]
The layout of a user-defined dialogue is stored in an UDL file. The following dialogue
elements are possible for the variable dialogue.
3.1 Dialogue Elements

3.1.1 Edit Box
Editbox Type Max
[Field#X] Inputtype 0 Number -
Name Title of the element Text 80
Length Maximum number of characters Number Int2
Text Text that shown in the edit box. Text 300
ShowStrLen Width of the edit boxes in characters. Number Uint2
PosX Position of the dialogue text in x- Number Int2

direction from the left margin of the
dialogue frame (0 = automatically)
PosY Position of the dialogue text in y- Number Int2

direction from the upper margin of the
dialogue frame ( 0 = automatically, -1=
previous value)
BoxPosX Position of the editbox in x-direction Number Int2

from the left margin of the dialogue
frame (0 = automatically)
BoxPosY Position of the edit box in y-direction Number Int2

from the upper margin of the dialogue
frame ( 0 = automatically, -1= previous
value)
VarName Name of the variable Text 254

Example
[Field#1]
Inputtype=0
Name=Variable Name
Length=31
Text=Variable Text
ShowStrLen=12
PosX=0 Automatically
positioning by the value
PosY=0 0.
BoxPosX=0
BoxPosY=0
VarName=VarText
3.1.2 Lable
Lable Type Max
Name Label Text 255


dialogue frame (0 = automatically, -1=
previous value)
Example
[Field#1] Output: none
Inputtype=1
Name=Variable Name
PosX=0
PosY=0
3.1.3 Check Box
Check Box Type Max
Name Text of the check box Text 80
Select Default value (If the value is 1 the Number 0/1

check box is selected)


previous value)
Example:
[Field#1]:
Inputtype=2
Name=Variable name
Select=0
PosX=0
PosY=0
VarName=Varcheck
3.1.4 Radion Buttons
Radio Button Type Max
Name Text of the radio button. Text 80
Select Default value (If the value is 1 the radio Number 0/1
button is selected)


previous value)
Radiobuttons that depend on one another must have one on the other following "Field-
Numbers". One group of radiobuttons is restricted by a dialogue element of an another type.
This is not nescessary if there is only one group of radiobuttons in the dialogue.
Example
[Field#1] You see the output of the
dialogue elements in two
Inputtype=3
variables.
Name=Variable Var1
Select=1
Var1 = 1 0
PosX=0
PosY=0 or
VarName=Var1 Var2 = 0 1
[Field#2]
Inputtype=3
Name=Variable Var2
Select=0
PosX=0
PosY=0
VarName=Va2
3.1.5 Call of Subdialogs
Definition Type Max
Name Text on the button. Text 80
IdfFile Path and file name of the IDF-file. FS
IdfSect Section of the IDF-file. 80


previous value)
Example
[Field#1] For the selection of the UDL dialogue in GEOPAK you must
indicate a section name as well known. That must occur
Inputtype=4
also here. The definition of the dialogue SubDlgGeo must
Name=Variable Var1 be in the same UDL file as the calling dialogue.
IdfSec= SubDlgGeo
PosX=0 Example: [Geo_Main]
PosY=0 •
•
•
[Geo_FieldXXX]
[SubDlgGeo_Main]
•
•
•
[SubDlgGeo_ FieldXXX]
3.1.6 Space
Space Type Max
High Height of the space in pixel Number Int2
Example
[Field#1]
Inputtype=5
High=20
3.1.7 Edit Box for Values
Valuebox Type Max
Length Maximum number of decimals. Number Int2
DefaultVal Default value. Text Real
Fix Number of decimal places. Number Int2
Max Maximum value Number Real
Min Minimum vale Number Real
ShowStrLen Width of the editbox in characters. Number Uint2


previous value)
BoxPosX Position of the edit box in x-direction Number Int2

from the left margin of the dialogue
frame (0 = automatically)
BoxPosY Position of the edit box in y-direction Number Int2
from the upper margin of the dialogue
frame (0 = automatically, -1= previous
value)
VarName Variable name Text 254

Example
[Field#1]
Inputtype=6
Name=Variable Name
Length=12
Fix=9
DefaultVal=1,234567890
Max=20,2360
Min= 0,1236
ShowStrLen=14
PosX=0
PosY=0
BoxPosX=0
BoxPosY=0
VarName=VarValue
3.1.8 Check Box with Special Output
CheckVal Type Max
Name Text of CheckVal Text 80

CheckVal is selected)


previous value)
Value Value for the output file. Text 80

Example
[Field#1] The output of the group of the

radiobuttons takes place in one
Inputtype=7
variable
Name=Var1
In this example
Select=1
(selection see picture)
PosX=0
PosY=0
VarChk =Chk_1,Chk_3
Value=Chk_1
VarName=VarChk
[Field#2]
Inputtype=7
Name=Var2
Select=0
PosX=0
PosY=0
Value=Chk_2
VarName=VarChk
[Field#3]
Inputtype=7
Name=Var3
Select=0
PosX=0
PosY=0
Value=Chk_3
VarName=VarChk
3.1.9 Radio Buttons with Special Output
Radiobutton Type Max
Name Text of Radio button. Text 80

Radio button is selected)


previous value)
Value Value for the output file. Text 80

Example
[Field#1] The output of the group of radio

buttons takes place in one variable.
Inputtype=8
Name= Var1
In this example.
Select=1
VarRdo=Rdo_1
PosX=0
PosY=0
Value=Rdo_1
VarName=VarRdo
[Field#2]
Inputtype=8
Name= Var2
Select=0
PosX=0
PosY=0
Value= Rdo_2
VarName=VarRdo
[Field#3]
Inputtype=8
Name= Var3
Select=0
PosX=0
PosY=0
Value= Rdo_3
VarName=VarRdo
3.1.10 List Box
Definition Type Max
Select Number of the list entry that should Number Int2

shown in the List box.
ShowStrLen Widths of the edit box in Number Uint2

characters.


direction from the upper margin of
the dialogue frame (0 =
automatically, -1= previous value)
BoxPosX Position of the edit box in x- Number Int2

BoxPosY Position of the edit box in y- Number Int2

direction from the upper margin of
the dialogue frame (0 =
automatically, -1= previous value)
NoOfElms Number of list elements Number UInt2
TextAndVar#X Text of the list entry and the value Text 254
that should write in the output file.
The first value is the text of the list
entry. The second value is the
value for the output file. A comma
detaches the values.
If you copy a picture to the button, the background colour of the picture changes if it
appears on the button. This means that all pixels with the colour of the outermost
pixel in the left upper corner of the picture will be automatically replaced through a
grey colour, according to Windows conventions (colour of the button).
Example:
If you want to have a red background on your button picture, you have to take care
that also at your bitmap, the outermost pixel above left is not red as well. If so, when
copying on the button, all red pixels would become grey.
But, if this pixel is e.g. blue, after copying on the button, only the blue pixel will
become grey. The red pixels stay red and they have a red background.
Radio Picture Button Type Max
[Field#X] Inputtype 10 Num -

ber
SelectBmp Picture that is displayed if the button is selected. Text 290

Here, you have to indicate the path and the file name.
DisSelectB Picture that is displayed if the button is selected. Text 290

mp Here, you have to indicate the path and the file name.
Select Default value ( When selecting = 1 the button is Num 0/1

selected ) ber
PosX Position of the button in X direction from the left Num

margin of the dialogue window.( 0 = autom. ) ber
PosY Position of the button in Y direction from the upper Num

margin of the dialogue window.( ( 0 = autom., -1= ber
preceding value )
Width Width of the button Num

ber
Height Height of the button Num

ber
Value Value that must be written in the INI file. Text 80
VarName variable name Text 254
IniSekt Section of the Ini file (If „“ then Ini section from call) Text 254
[Field#1] [Field#3]
Inputtype=10 Inputtype=10
SelectBmp=..\Layout\Dog.bmp Select=0
DisSelectBmp=..\Layout\Dog_No.bmp SelectBmp=..\Layout\Fish.bmp
Select=1 DisSelectBmp=..\Layout\Fish_No.bmp
PosX=10 PosX=230
PosY=10 PosY=10
Width=100 Width=100
Height=100 Height=100
Value=Dog Value=Fish
VarName=Animal VarName=Animal
[Field#2] [Field#4]
Select=0 Select=0
SelectBmp=..\Layout\Cat.bmp SelectBmp=..\Layout\Bird.bmp
DisSelectBmp=..\Layout\Cat_No.bmp DisSelectBmp=..\Layout\Bird_No.bmp
PosX=120 PosX=340
PosY=10 PosY=10
Width=100 Width=100
Value=Cat Value=Bird
Output in the INI file:

Animal= Fish
Check Picture Button Type Max
[Field#X] Inputtype 11 Num -

ber
SelectBmp Picture that is displayed if the button is selected. Text 290

Here, you have to indicate the path and the file name.
DisSelectB Picture that is displayed if the button is selected. Text 290

mp Here, you have to indicate the path and the file name.
Select Default value ( When selecting = 1 the button is Num 0/1

selected ) ber
PosX Position of the button in X direction from the left Num

margin of the dialogue window.( 0 = autom. ) ber
PosY Position of the button in Y direction from the upper Num

margin of the dialogue window. ( 0 = autom., -1= ber
preceding value )
Width Width of the button Num

ber
Height Height of the button Num

ber
SelValue Value that must be written in the INI file. Text 80
DisValue Value that must be written in the INI file. Text 80
VarName variable name Text 254
IniSekt Section of the Ini file (If „“ then Ini section from call) Text 254
[Field#1] [Field#3]
Select=1 Select=0
SelectBmp=..\Layout\Dog.bmp SelectBmp=..\Layout\Fish.bmp
DisSelectBmp=..\Layout\Dog_No.bmp DisSelectBmp=..\Layout\Fish_No.bmp
PosX=10 PosX=230
PosY=10 PosY=10
Width=100 Width=100
SelValue=Dog SelValue=Fish
CatOrDog=Animal VarName=Animal
[Field#2] [Field#4]
Select=0 Select=0
PosX=120 PosX=340
PosY=10 PosY=10
Width=100 Width=100
SelValue=Cat SelValue=Bird

Animal= Dog,Fish,Bird
Application example 2
Description:
In this example, for each button a value will be written in the output file. For this, you
only have to input a value for the DisValue parameter.
[Field#1] [Field#3]
Select=1 Select=0
SelectBmp=..\Layout\Dog.bmp SelectBmp=..\Layout\Fish.bmp
DisSelectBmp=..\Layout\Dog_No.bmp DisSelectBmp=..\Layout\Fish_No.bmp
PosX=10 PosX=230
PosY=10 PosY=10
Width=100 Width=100
SelValue=Yes SelValue=Yes
DisValue=No DisValue=No
VarName=Dog VarName=Fish
[Field#2] [Field#4]
Select=0 Select=0
PosX=120 PosX=340
PosY=10 PosY=10
Width=100 Width=100
SelValue=Yes SelValue=Yes
DisValue=No DisValue=No
VarName=Cat VarName=Bird
Dog=No
Cat=No
Fish=Yes
Bird=Yes
Application example 3
Description: In this example, a change-over switch is realized with the Check Picture
Button. If you actuate the respective button, you can change between the dog and the
cat, as well as the fish and the bird.
Output 1
Output 2
[Field#1] Output 1 in the INI file:
Inputtype=11
Select=1 CatOrDog=Cat
SelectBmp=..\Layout\Dog.bmp FishOrBird=Bird
DisSelectBmp=..\Layout\Cat.bmp
PosX=10
PosY=10
Width=100 Output 1 in the INI file:
Height=100
SelValue=Dog
DisValue=Cat CarOrDog=Dog
VarName=CatOrDog FishOrBird=Fish
[Field#2]
Inputtype=11
Select=0
SelectBmp=..\Layout\Fish.bmp
DisSelectBmp=..\Layout\Bird.bmp
PosX=120
PosY=10
Width=100
Height=100
SelValue=Fish
DisValue=Bird
VarName=FishOrBird
Creation of the file
Example
[Field#1] The output of the list box takes
place in one variable.
Inputtype=9
Name= Variable Name
In this example.
Select=1
VarList= List_3
ShowStrLen=12
PosX=10
PosY=280
BoxPosX=120
BoxPosY=280
NoOfElms=10
VarName=VarList
TextAndVar#1 =Listeneintrag_0, List_1
TextAndVar#2 =Listeneintrag_1, List _2
19.08.02 v 1.5 31
Using GEOPAK variables in the UDL dialogues

For the default values of the different dialogue elements, you can also use
variables. These variables must be defined before starting the dialogue in
GEOPAK so that it will be possible to take over the variable value of
GEOPAK in the dialogue. For the variables, the same formatting syntax will
be used as for the variables in GEOPAK. As example, here you see the
default value for a text input field.
Example: [Field#1]
Inputtype=0
Name=Variable Name
Length=31
Text=@[Name of the string variable out of GEOPAK]
Or
Text=@[Name of the variable out of GEOPAK:3)
This functionality is available for the following dialogue elements:
Text input field

check box
option buttons
input field for numbers
check boxes with special output
options with special tasks
list box.
32 v 1.5 19.08.02
For the check boxes and the option buttons, the valid return codes are True
and False or 1 and 0. For the check boxes and the option buttons with
special tasks, the value having been registered under “Value” must be
returned by GEOPAK so that the check boxes or the option button must be
set
Example check boxes with special output:
[Field#1] If you want that

Inputtype=7 both check boxes
Name=Var1 will be selected after
having started the dialogue,
Select=@[ VarIni] you will have to input the
PosX=0 string variable in GEOPAK as
PosY=0 follows.
Value=Ini1
VarName=VarIni VarIni = Ini1,Ini2
[Field#2]
Inputtype=7
Name=Var2
Select=@[ VarIni]
PosX=0
PosY=0
Value=Ini2
VarName=VarIni
For the list field, you only have to return the number of the list input.
19.08.02 v 1.5 33
Example for a user defined file
4 Example for a user defined file

1
2
0
3
20
40
60
80
4
100
120
5 140
160
180
0 20 40 60 80 100 120 140 160 180 200 220 240 260 280
(Pixel )
In this example (picture above) you operate with the following dialogue
items: Text input, display text, check boxes and radio buttons.
34 v 1.5 19.08.02
4.1 So You Write Your UDL-File

1 Settings of the dialogue window
[Geo_Main]
Name=Input variables for GEOPAK-Win (Example #1)
NoOfFields=7
Help=0
PosX=150
PosY=50
2 Text field
[Geo_Field#1]
Inputtype=1
Name=Co-ordinate system
PosX=10
PosY=10
3 Radio buttons
With these two radio buttons the variable AlignMode is input.
[Geo_Field#2]
Inputtype=8
Name=Manual alignment
Select=0
PosX=20
PosY=30
VarName=AlignMode
Value=1
[Geo_Field#3]
Inputtype=8
Name=Load co-ordinate system
Select=1
PosX=20
PosY=50
VarName=AlignMode
19.08.02 v 1.5 35
Value=2
4 Text input
[Geo_Field#4]
Inputtype=0
Name=Co-ordinate sys. no.
Length=12
Text=1
ShowStrLen=4
PosX=40
PosY=70
BoxPosX=220
BoxPosY=70
VarName=CosyNo
5 Check boxes
Check boxes are used, if the value of variables is to take only the
value 1
or 0.
[Geo_Field#6]
Inputtype=2
Name=Meas. results to printer
Select=1
PosX=20
PosY=120
VarName=fPrint
[Geo_Field#7]
Inputtype=2
Name=Meas. results to file
Select=0
PosX=20
PosY=140
VarName=fFile
36 v 1.5 19.08.02
4.2 Example Dialogue Geo
[Geo_Main]
NoOfFields=7
Help=0
PosX=0
PosY=0
LastValue=2
[Geo_Field#1]
Inputtype=1 [Geo_Field#3]
Name=Co-ordinate system Inputtype=8
PosX=10 Name=Load co-ordinate system
PosY=10 Select=1
PosX=20
[Geo_Field#2] PosY=50
Inputtype=8 VarName=AlignMode
Name=Manual alignment Value=2
Select=0
PosX=20 [Geo_Field#4]
PosY=30 Inputtype=0
VarName=AlignMode Name=Co-ordinate sys. no.
Value=1 Length=12
19.08.02 v 1.5 37
Text=1 Inputtype=2
ShowStrLen=4 Name=Meas. results to printer
PosX=40 Select=1
PosY=70 PosX=20
BoxPosX=220 PosY=120
BoxPosY=70 VarName=fPrint
VarName=CosyNo
[Geo_Field#7]
[Geo_Field#5] Inputtype=2
Inputtype=1 Name=Meas. results to file
Name=Output Select=0
PosX=10 PosX=20
PosY=100 PosY=140
VarName=fFile
[Geo_Field#6]
38 v 1.5 19.08.02
4.3 Example Dialogue GeoSel
[GeoSel_Main]
NoOfFields=4
Help=0
PosX=150
PosY=50
[GeoSel_Field#1] Inputtype=8
Inputtype=1 Name=Only 16 circles
Name=Kind of measurement Select=1
PosX=10 PosX=20
PosY=0 PosY=0
VarName=MeasureKind
[GeoSel_Field#2] Value=2
Inputtype=8
Name=Measure whole program [GeoSel_Field#4]
Select=0 Inputtype=8
PosX=20 Name=Only 4 circles
PosY=0 Select=0
VarName=MeasureKind PosX=20
Value=1 PosY=0
VarName=MeasureKind
[GeoSel_Field#3] Value=3
19.08.02 v 1.5 39
4.4 Example Dialogue StartAsk
[StartAsk_Main]
NoOfFields=3
Help=0
PosX=150
PosY=50
[StartAsk_Field#1] BoxPosX=220
Inputtype=1 BoxPosY=60
Name=Abfrage Stamm- und VarName=StammNr
Auftrags-Nr.
PosX=10 [StartAsk_Field#3]
PosY=20 Inputtype=6
Name=Auftragsnummer
[StartAsk_Field#2]
Length=12
Inputtype=6
Fix=0
Name=Stammnummer
DefaultVal=0000
Length=12
Max=999999
Fix=0
Min=0
DefaultVal=0000
ShowStrLen=8
Max=999999
PosX=40
Min=0
PosY=80
ShowStrLen=8
BoxPosX=220
PosX=40
BoxPosY=80
PosY=60
VarName=AuftragsNr
40 v 1.5 19.08.02
4.5 Example Dialogue String
[String_Main]
Name=Input text variables for GEOPAK-Win
NoOfFields=2
Help=0
PosX=0
PosY=0
[String_Field#1] [String_Field#2]
Name=InpStr1: Name=InpStr2:
Text=@Operator Text=@PartProgName
Length=80 Length=80
ShowStrLen=20 ShowStrLen=20
VarName=InpStr1 VarName=InpStr2
19.08.02 v 1.5 41

Specifications For User Defined Dialogs: Manual With Examples V 1.5

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Specifications For User Defined Dialogs: Manual With Examples V 1.5

Uploaded by

Copyright:

Available Formats

Specifications for

User Defined Dialogs

Manual with Examples v 1.5

4 Example for a user defined file .............................. 34

The file for the user-defined dialogue

2.1 Take Notice

! You always use only a UDL file.

Special designation: Geo

Main Section Type Max

[Main] Name Dialogue Heading Text 80

NoOfFields Number of dialogue elements ( Number 999

Help Call the Notepad to view help texts Number 0/1

Helpfile Path und file name of the help file Text FS

LastValue Pre-define the dialogue elements with Number

PosX Position of window in X direction from Number Int2

PosY Position of window in Y direction from Number Int2

3.1 Dialogue Elements

[Field#X] Inputtype 0 Number -

Name Title of the element Text 80

Length Maximum number of characters Number Int2

Text Text that shown in the edit box. Text 300

ShowStrLen Width of the edit boxes in characters. Number Uint2

PosX Position of the dialogue text in x- Number Int2

PosY Position of the dialogue text in y- Number Int2

BoxPosX Position of the editbox in x-direction Number Int2

BoxPosY Position of the edit box in y-direction Number Int2

VarName Name of the variable Text 254

Lable Type Max

[Field#X] Inputtype 1 Number -

Name Label Text 255

PosX Position of the dialogue text in x- Number Int2

PosY Position of the dialogue text in y- Number Int2

Check Box Type Max

[Field#X] Inputtype 2 Number -

Name Text of the check box Text 80

Select Default value (If the value is 1 the Number 0/1

PosX Position of the dialogue text in x- Number Int2

PosY Position of the dialogue text in y- Number Int2

VarName Name of the variable Text 254

Radio Button Type Max

[Field#X] Inputtype 3 Number -

Name Text of the radio button. Text 80

PosX Position of the dialogue text in x- Number Int2

PosY Position of the dialogue text in y- Number Int2

VarName Name of the variable Text 254

Definition Type Max

[Field#X] Inputtype 4 Number -

Name Text on the button. Text 80

IdfFile Path and file name of the IDF-file. FS

IdfSect Section of the IDF-file. 80

PosX Position of the dialogue text in x- Number Int2

PosY Position of the dialogue text in y- Number Int2

Space Type Max

[Field#X] Inputtype 5 Number -

High Height of the space in pixel Number Int2

3.1.7 Edit Box for Values

Valuebox Type Max

[Field#X] Inputtype 6 Number -

Name Title of the element Text 80

Length Maximum number of decimals. Number Int2

DefaultVal Default value. Text Real

Fix Number of decimal places. Number Int2

Max Maximum value Number Real