 |
ALPHA-VISION® Functions: aci.Obj_SetTxt
|
aci.Obj_SetTxt
SUMMARY
Set the text of a data object as an application.
SYNTAX
aci.Obj_SetTxt(
(<object number>|<point id>),
<language>,
<text>)
ARGUMENTS
- object number (type:number)
-
A data object number
- point id (type:string)
-
The name of a data object
- language (type:string)
-
The language is a one-character id defined for the project.
- text (type:string)
-
The new text.
ERROR HANDLING
The function will fail and terminate script execution if strict error checking is enabled (see
aci.SetStrictMode()) and
one of the following conditions is met:
-
The given data object does not exist.
-
The text cannot be set.
DESCRIPTION
The new text will not be directly written to the process image in
aci.dll
but it will be sent to the data object's station (e.g. a PLC) via the driver handling this station.
The station then sends the text to all operator stations.
System objects are handled internally and don't require a station.
This function may be applied to string-PVs and system objects.
EXAMPLES
aci.Obj_SetTxt("MESSAGE", "E", "Hello wolrd!")
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