SetDataVector()
Summary
Fills values into a field in a view|set from a vector.
Changes
Added to Version 6.0/2012.
Syntax
SetDataVector(string viewset, string field, vector v, array options)
| Argument | Contents |
|---|---|
| viewset | The name of the view|set |
| field | The name of the field |
| v | A vector |
| Options | Type | Contents |
|---|---|---|
| Sort Order | Array | An array of arrays with two strings, the name of the field and "Ascending" or "Descending," for each field in the sort order |
Notes
SetDataVector() displays a progress bar when setting a large number of records. To add a Cancel button to the progress bar, precede the function call with an "on escape" clause. For more information, see Error Handling.
An example of a Sort Order option: {{"Sort Order",{{Field1,"Ascending"},{Field2,"Descending"}}}}
For more information on vectors, see Vectors.
Example
// First open customer.dbf in the Tutorial folder for exclusive access
// and modify the table to add an Integer field TotalSales of width 12
view_name = GetView()
v1 = GetDataVector(view_name+"|", "SALES", )
v2 = GetDataVector(view_name+"|", "LAST_YEAR", )
v3 = v1 + v2
SetDataVector(view_name+"|", "TotalSales", v3, )
RedrawEditor(view_name)See Also
| GISDK Function | Summary |
|---|---|
| ArrayToVector() | Copies an array to a vector |
| CopyVector() | Copies a vector to a new vector |
| CumulativeVector() | Constructs a cumulative vector in a new vector |
| ConcatenateVectors() | Concatenates vectors into one, combined long vector |
| GetDataVector() | Creates a vector from a field in a view|set |
| GetDataVectors() | Creates vectors from fields in a view|set |
| SetDataVectors() | Fills values into fields in a view|set from vectors |
| SortVector() | Sorts the elements of a vector in ascending order |
| SortVectors() | Sorts an array of vectors in ascending order, based on the first vector |
| TransposeArray() | Transposes an array of arrays, where element b[i][j] = a[j][i] |
| Vector() | Creates a vector |
| VectorStatistic() | Computes a given statistic for the vector |
| VectorToArray() | Copies a vector to an array |