ComponentGroup – Aspire Only: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 8: | Line 8: | ||
===.GetCount=== | ===.GetCount=== | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (integer) the number of components in the group | '''Returns:''' (integer) the number of components in the group | ||
===.Count=== | ===.Count=== | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (integer) the number of components in the group | '''Returns:''' (integer) the number of components in the group | ||
===.IsEmpty=== | ===.IsEmpty=== | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (bool) true if the group is empty | '''Returns:''' (bool) true if the group is empty | ||
==Methods== | ==Methods== | ||
| Line 22: | Line 22: | ||
===:GetHead()=== | ===:GetHead()=== | ||
'''Returns:''' (the component at the head of the group, the component remains in the group | '''Returns:''' (the component at the head of the group, the component remains in the group | ||
===:GetHeadPosition()=== | ===:GetHeadPosition()=== | ||
'''Returns:''' (POSITION) a variable to allow access to the head of the list of components in the group | '''Returns:''' (POSITION) a variable to allow access to the head of the list of components in the group | ||
===:GetTailPosition()=== | ===:GetTailPosition()=== | ||
'''Returns:''' (POSITION) a variable to allow access to the tail of the list of components in the group | '''Returns:''' (POSITION) a variable to allow access to the tail of the list of components in the group | ||
===:GetNext(POSITION pos)=== | ===:GetNext(POSITION pos)=== | ||
'''Returns:''' Both the component at the current position '''AND''' a new value for position pointing to the next item in the group (or nil if at end of group) | '''Returns:''' Both the component at the current position '''AND''' a new value for position pointing to the next item in the group (or nil if at end of group) | ||
pos (POSTION) current position in group | pos (POSTION) current position in group | ||
===:GetPrev(POSITION pos)=== | ===:GetPrev(POSITION pos)=== | ||
'''Returns:''' Both the component at the current position '''AND''' a new value for position pointing to the previous item in the group (or nil if at end of group) | '''Returns:''' Both the component at the current position '''AND''' a new value for position pointing to the previous item in the group (or nil if at end of group) | ||
pos (POSTION) current position in group | pos (POSTION) current position in group | ||
===:GetAt(POSITION pos)=== | ===:GetAt(POSITION pos)=== | ||
'''Returns:''' the component at the passed position | '''Returns:''' the component at the passed position | ||
pos (POSTION) position in group | pos (POSTION) position in group | ||
=DocumentVariableList= | =DocumentVariableList= | ||
| Line 51: | Line 51: | ||
===:DocumentVariableExists (string variable_name)=== | ===:DocumentVariableExists (string variable_name)=== | ||
'''Returns:''' (bool) true if a DocumentVariable with the passed name exists | '''Returns:''' (bool) true if a DocumentVariable with the passed name exists | ||
Variable_name (string) Name for variable | |||
===:GetDocumentVariable (string variable_name)=== | ===:GetDocumentVariable (string variable_name)=== | ||
'''Returns:''' a DocumentVariable with the passed name if exists otherwise nil | '''Returns:''' a DocumentVariable with the passed name if exists otherwise nil | ||
Variable_name (string) Name for variable | |||
===:SetDocumentVariable (string variable_name, double value)=== | ===:SetDocumentVariable (string variable_name, double value)=== | ||
Sets the DocumentVariable with the specified name to the passed value. It either creates a new variable if one with the passed name does not exist or updates the current one to the new value. Please see the documentation for IsInvalidDocumentVariableName as to what constitutes a valid variable name. | Sets the DocumentVariable with the specified name to the passed value. It either creates a new variable if one with the passed name does not exist or updates the current one to the new value. Please see the documentation for IsInvalidDocumentVariableName as to what constitutes a valid variable name. | ||
Variable_name (string) Name for variable | |||
Value(double) value of the variable | |||
===:DocumentVariable True(string variable_name)=== | ===:DocumentVariable True(string variable_name)=== | ||
'''Returns:''' (bool) true if a DocumentVariable with the passed name is deleted otherwise false. Please note DocumentVariables considered to be in use cannot be deleted. | '''Returns:''' (bool) true if a DocumentVariable with the passed name is deleted otherwise false. Please note DocumentVariables considered to be in use cannot be deleted. | ||
Variable_name (string) Name for variable | |||
===:GetHeadPosition()=== | ===:GetHeadPosition()=== | ||
'''Returns:''' (POSITION) a variable to allow access to the head of the list of DocumentVariables in the list | '''Returns:''' (POSITION) a variable to allow access to the head of the list of DocumentVariables in the list | ||
===:GetNext(POSITION pos)=== | ===:GetNext(POSITION pos)=== | ||
'''Returns:''' Both the DocumentVariable at the current position '''AND'''a new value for position pointing to the next item in the list (or nil if at end of list) | '''Returns:''' Both the DocumentVariable at the current position '''AND'''a new value for position pointing to the next item in the list (or nil if at end of list) | ||
pos (POSTION) current position in group | |||
=DocumentVariable= | =DocumentVariable= | ||
| Line 90: | Line 89: | ||
===.Name=== | ===.Name=== | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (string) the name of the DocumentVariable | '''Returns:''' (string) the name of the DocumentVariable | ||
===.Value=== | ===.Value=== | ||
'''Interaction:''' Read Only | '''Interaction:''' Read Only | ||
'''Returns:''' (double) the value of the DocumentVariable | '''Returns:''' (double) the value of the DocumentVariable | ||
[[File:Back.jpg|right|50px|link=Aspire Only]] | [[File:Back.jpg|right|50px|link=Aspire Only]] | ||
==References== | ==References== | ||
'''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 10.0, published August 21, 2019. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information] | '''Please Note:''' The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 10.0, published August 21, 2019. by Vectric Ltd. Most current document from Vertric can be downloaded at [https://gadgets.vectric.com/developerinfo.html Vertric Developer Information] | ||
Latest revision as of 17:56, 1 May 2024
This object represents a group of Components. A ComponentGroup may contain ComponentGroups.
Properties
.GetCount
Interaction: Read Only
Returns: (integer) the number of components in the group
.Count
Interaction: Read Only
Returns: (integer) the number of components in the group
.IsEmpty
Interaction: Read Only
Returns: (bool) true if the group is empty
Methods
:GetHead()
Returns: (the component at the head of the group, the component remains in the group
:GetHeadPosition()
Returns: (POSITION) a variable to allow access to the head of the list of components in the group
:GetTailPosition()
Returns: (POSITION) a variable to allow access to the tail of the list of components in the group
:GetNext(POSITION pos)
Returns: Both the component at the current position AND a new value for position pointing to the next item in the group (or nil if at end of group) pos (POSTION) current position in group
:GetPrev(POSITION pos)
Returns: Both the component at the current position AND a new value for position pointing to the previous item in the group (or nil if at end of group) pos (POSTION) current position in group
:GetAt(POSITION pos)
Returns: the component at the passed position pos (POSTION) position in group
DocumentVariableList
This object is responsible for managing all the document variables associated with a Job. A reference to a DocumentVariableList is obtained via the DocumentVariables property of the VectricJob.
- local document_variable_list = job.DocumentVariables
Methods
:DocumentVariableExists (string variable_name)
Returns: (bool) true if a DocumentVariable with the passed name exists Variable_name (string) Name for variable
:GetDocumentVariable (string variable_name)
Returns: a DocumentVariable with the passed name if exists otherwise nil Variable_name (string) Name for variable
:SetDocumentVariable (string variable_name, double value)
Sets the DocumentVariable with the specified name to the passed value. It either creates a new variable if one with the passed name does not exist or updates the current one to the new value. Please see the documentation for IsInvalidDocumentVariableName as to what constitutes a valid variable name.
Variable_name (string) Name for variable Value(double) value of the variable
:DocumentVariable True(string variable_name)
Returns: (bool) true if a DocumentVariable with the passed name is deleted otherwise false. Please note DocumentVariables considered to be in use cannot be deleted. Variable_name (string) Name for variable
:GetHeadPosition()
Returns: (POSITION) a variable to allow access to the head of the list of DocumentVariables in the list
:GetNext(POSITION pos)
Returns: Both the DocumentVariable at the current position ANDa new value for position pointing to the next item in the list (or nil if at end of list) pos (POSTION) current position in group
DocumentVariable
This object is a name of value pair that represents a Document Variable within a VectricJob.
Properties
.Name
Interaction: Read Only
Returns: (string) the name of the DocumentVariable
.Value
Interaction: Read Only
Returns: (double) the value of the DocumentVariable
References
Please Note: The base material for the contents found in this WiKi was sourced from Vectric Lua Interface for Gadgets, version 10.0, published August 21, 2019. by Vectric Ltd. Most current document from Vertric can be downloaded at Vertric Developer Information