Usr_GetObjList

ALPHA-VISION^® Functions of Data Object Server: Usr_GetObjList

Usr_GetObjList

SUMMARY

Usr_GetObjList - direct read in of Data Objects

SYNTAX

Usr_GetObjList(iniFILE,Section);

ARGUMENTS

iniFILE: 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

PointIDs

DESCRIPTION

Allows to hand over up to 99 PointIDs to a Window.

How the job is used:

To a button the following actions are bound:


         				Usr_GetObjList(test.ini,s_1_dir)

         				Wnd_Dialog(TEST1,5)

It refers to the following ini-file / section: -

test.ini
:
:
[s_1_dir]
01=Test_10
02=Test_11
03=Test_12
04=Test_13
05=Test_14
[next_Section]
:
:

- the following Data Objects are read

Test_10
Test_11
Test_12
Test_13
Test_14

After handing over to Dialog Window "TEST1":

PointID Test_10 is available as $Wnd5
PointID Test_11 as $Wnd4
PointID Test_12 as $Wnd3
PointID Test_13 as $Wnd2
PointID Test_14 as $Wnd1

Hints and Tips:

only PointIDs can be handed over
the section must start with "01="
the lines must be serially numbered

Note:

The section should not have more lines than parameters are handed over. If e.g. the section has 10 lines and only 5 parameters are handed over the result will be undefined.

EXAMPLES

Usr_GetObjList(test.ini,s_2_dir); Wnd_Dialog(Dia_01,3)

The Data Objects of the section ‘s_2_dir’ within the file ‘test.ini’ are read.
3 Data Objects are handed over to the Dialog Window ‘Dia_01’.

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