Difference between revisions of "CATable::GetDataByElements"
(Marked this version for translation) |
|||
| Line 3: | Line 3: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
| − | = [[CATable]]::GetDataByElements(indexPositions) = | + | = [[CATable]]::GetDataByElements(indexPositions) = <!--T:1--> |
| + | <!--T:2--> | ||
Retrieves the value of an input table cell according to «indexPositions», which specify the 1-based position along each index of the table in order. | Retrieves the value of an input table cell according to «indexPositions», which specify the 1-based position along each index of the table in order. | ||
| + | <!--T:3--> | ||
The parameter specifies the coordinates of a cell in the table, using the position along the index, with position 1 being the first element([[CATable::GetDataByLabels]] does the same using index labels). When the table is one dimensional, «indexPositions» be a single interger value. Otherwise, «indexPositions» must be an array with ''N'' numbers when the table is ''N''-dimensional. | The parameter specifies the coordinates of a cell in the table, using the position along the index, with position 1 being the first element([[CATable::GetDataByLabels]] does the same using index labels). When the table is one dimensional, «indexPositions» be a single interger value. Otherwise, «indexPositions» must be an array with ''N'' numbers when the table is ''N''-dimensional. | ||
| + | <!--T:4--> | ||
The order of the dimensions, as they are listed in «indexPositions», is determined by a previous call to [[CATable::SetIndexOrder]]. | The order of the dimensions, as they are listed in «indexPositions», is determined by a previous call to [[CATable::SetIndexOrder]]. | ||
| + | <!--T:5--> | ||
The return value is the value of the table cell. The manner in which this value is returned is determined by the [[CATable::RenderingStyle]]. | The return value is the value of the table cell. The manner in which this value is returned is determined by the [[CATable::RenderingStyle]]. | ||
| + | <!--T:6--> | ||
When the result table is zero-dimensional (i.e., atomic, not an array), you must use [[CATable::AtomicValue]] to access the value. | When the result table is zero-dimensional (i.e., atomic, not an array), you must use [[CATable::AtomicValue]] to access the value. | ||
| − | = Examples = | + | = Examples = <!--T:7--> |
| − | == In VB == | + | == In VB == <!--T:8--> |
| − | dim editTab as CATable = var2d.DefTable | + | <!--T:9--> |
| + | dim editTab as CATable = var2d.DefTable | ||
| − | dim coord(1) ' Contains two elements, (0) and (1) | + | <!--T:10--> |
| + | dim coord(1) ' Contains two elements, (0) and (1) | ||
coord(0) = 3 | coord(0) = 3 | ||
coord(1) = 2 | coord(1) = 2 | ||
| Line 28: | Line 35: | ||
ET = editTab.GetDataByElements(coord) | ET = editTab.GetDataByElements(coord) | ||
| − | dim resTab as CATable = var2d.ResultTable | + | <!--T:11--> |
| + | dim resTab as CATable = var2d.ResultTable | ||
resTab.SetIndexOrder( Split("I,J",",")) | resTab.SetIndexOrder( Split("I,J",",")) | ||
RT = resultTab.GetDataByElements(coord) | RT = resultTab.GetDataByElements(coord) | ||
| − | RT1 = var1d.ResultTable.GetDataByElements(4) | + | <!--T:12--> |
| + | RT1 = var1d.ResultTable.GetDataByElements(4) | ||
| − | = Error Codes = | + | = Error Codes = <!--T:13--> |
| + | <!--T:14--> | ||
:24 – “Subscripts must be an array of variants” | :24 – “Subscripts must be an array of variants” | ||
:25 – “Subscripts cannot be accessed” | :25 – “Subscripts cannot be accessed” | ||
| Line 43: | Line 53: | ||
:30 – “Position does not exist” | :30 – “Position does not exist” | ||
| − | = See Also = | + | = See Also = <!--T:15--> |
| + | <!--T:16--> | ||
* [[CATable::SetIndexOrder]] | * [[CATable::SetIndexOrder]] | ||
* [[CATable::RenderingStyle]] and [[CARenderingStyle]] | * [[CATable::RenderingStyle]] and [[CARenderingStyle]] | ||
Latest revision as of 01:07, 16 June 2015
ADE User Guide > ADE Server Class Reference > CATable
CATable::GetDataByElements(indexPositions)
Retrieves the value of an input table cell according to «indexPositions», which specify the 1-based position along each index of the table in order.
The parameter specifies the coordinates of a cell in the table, using the position along the index, with position 1 being the first element(CATable::GetDataByLabels does the same using index labels). When the table is one dimensional, «indexPositions» be a single interger value. Otherwise, «indexPositions» must be an array with N numbers when the table is N-dimensional.
The order of the dimensions, as they are listed in «indexPositions», is determined by a previous call to CATable::SetIndexOrder.
The return value is the value of the table cell. The manner in which this value is returned is determined by the CATable::RenderingStyle.
When the result table is zero-dimensional (i.e., atomic, not an array), you must use CATable::AtomicValue to access the value.
Examples
In VB
dim editTab as CATable = var2d.DefTable
dim coord(1) ' Contains two elements, (0) and (1)
coord(0) = 3
coord(1) = 2
editTab.SetIndexOrder( Split("I,J",",") )
ET = editTab.GetDataByElements(coord)
dim resTab as CATable = var2d.ResultTable
resTab.SetIndexOrder( Split("I,J",","))
RT = resultTab.GetDataByElements(coord)
RT1 = var1d.ResultTable.GetDataByElements(4)
Error Codes
- 24 – “Subscripts must be an array of variants”
- 25 – “Subscripts cannot be accessed”
- 26 – “Lower bound of subscript array inaccessible”
- 27 – “Upper bound of subscript array inaccessible”
- 28 – “Must specify at least one element in table”
- 30 – “Position does not exist”
See Also
Comments
Enable comment auto-refresher