ALPHA-VISION® DataObject dependent Actions: Usr_SetRefObjs

Usr_SetRefObjs

SUMMARY

Usr_SetRefObjs

SYNTAX

Usr_SetRefObjs(<inifile>,<sektion>);

ARGUMENTS

*.ini

Name of the *.ini file were the Section can be found.

Section

Name of the Section within the *.ini file were the references should be read from.

DESCRIPTION

Allows to allocate blocks of reference objects.

Hints:

• The reference objects defined in the *.ini file must exist.
• The file extension “.ini” must be omitted when defining the file.
• The reference definition list should be a self-contained file.
• Any entry in that file must be made in UPPER case.
• Any allocation made that way is lost when the runtime is closed down.

Known Errors
When creating Reference Objets using the BROWSER / AvEt that one on the last position is not recognized.

Solution:
Define a dummy Reference Object as the last one e.g. "ZZZZZ".

see also:

- RfPo_ClearRefId
- RfPo_Descr
- RfPo_SetRefId

EXAMPLES

Usr_SetRefObjs(test,Sektion_1);

File:
"TEST.INI"

[SEKTION_1]
REF_A=TEST_10
REF_B=TEST_11
REF_C=TEST_12
REF_D=TEST_13
[SEKTION_2]
REF_A=TEST_21
:
:

The Reference Objects REF_A to REF_D are replaced by Test_10 to Test_13.

---

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