SelectByIDs()
Summary
Selects map features from a list of feature IDs.
Changes
Optional options array introduced in Version 5.0.
Syntax
n_selected = SelectByIDs(string set_name, string operation, array IDs [, array options])
| Argument | Contents |
|---|---|
| set_name | The name of the selection set |
| operation | The operation to perform, as indicated below |
| IDs | The IDs of the features to be selected |
| Operation | Meaning |
|---|---|
| several | Replaces the contents of the selection set |
| less | Removes features from the selection set |
| more | Adds features to the selection set |
| subset | Selects a subset of the selection set |
| Option | Type | Contents |
|---|---|---|
| Max | Integer | Maximum number of records to select |
| Display | Boolean | "True" or "False" overriding the current setting; for more information, see SetSelectDisplay() |
| Auto Redraw | Boolean | "True" or "False" overriding the current setting; for more information, see SetSelectAutoRedraw() |
| Source And | String | A selection set on the current layer that records must be in to be selected |
| Source Not | String | A selection set on the current layer that records must not be in to be selected |
Returns
An integer indicating the number of records in the selection set.
Notes
-
The options array is an optional argument.
-
All selection commands operate on the current layer.
-
If the set does not already exist, SelectByIDs() creates it.
Example
SelectByIDs("Selection", "More", {14, 25, 128})Error Codes
| Error Type | Meaning |
|---|---|
| Error | The set name or operation type is invalid or the array of IDs is empty. |
See Also
| Function | Summary |
|---|---|
| SelectByIDFile() | Selects map features from a list of feature IDs stored in a file |