Usr_GetObjInd

SUMMARY

Usr_GetObjInd

SYNTAX

Usr_GetObjInd(file.ini,section);

ARGUMENTS

file.ini
Name of the *.ini file from where the Data Objects should be read.
Section
Name of the section within the *.ini file from where the Data Objects should be read.

RETURN VALUE

Actual value(s) of the defined Data Object(s).

DESCRIPTION

Allows to hand over up to 99 indirect (via Object Numbers) addressed PointIDs to a Window.
The defined ini-File must be available in the runtime directory.

How the job is used:

To a button the following actions are bound:

Usr_GetObjInd(test.ini,s_1_ind)
Wnd_Dialog(TEST1,6)

It refers to the following ini-file:
test.ini
:
:
[s_1_ind]
01=Test_10
02=Test_11
03=Test_12
04=Test_13
05=Test_14
06=Test_15
[next_Section]
:
:

The job then:

interprets the value of Test_10 as 'ObjNr.' and converts it to the appropriate PointID "n10".
interprets the value of Test_11 as 'ObjNr.' and converts it to the appropriate PointID "n11".
interprets the value of Test_12 as 'ObjNr.' and converts it to the appropriate PointID "n12".
interprets the value of Test_13 as 'ObjNr.' and converts it to the appropriate PointID "n13".
interprets the value of Test_14 as 'ObjNr.' and converts it to the appropriate PointID "n14".
interprets the value of Test_15 as 'ObjNr.' and converts it to the appropriate PointID "n15".

After handing over to Dialog Window "TEST1":

PointID "n10" is available as $Wnd6
PointID "n11" is available as $Wnd5
PointID "n12" is available as $Wnd4
PointID "n13" is available as $Wnd3
PointID "n14" is available as $Wnd2
PointID "n15" is available as $Wnd1

Note:
Data Object type of Test_10 to _15 has to be integer.


If the value(s) of any Data Object (Test_10 to _15) change an update may be performed by repressing the button or via the job: Obj_RfrParLstInd

EXAMPLES

Usr_GetObjInd(test.ini,s_1_ind);

Syntax Notation
[aaa]
aaa is optional (zero or one occurences)
(aaa|bbb)
aaa exclusive or bbb
(aaa)*
aaa may occur indefinitely often or may be omitted
(aaa)+
aaa may occur indefinitely often but at least once
(aaa)m..n
aaa may occur from m to n times