CreateGroup()
Summary
Creates multiple selection sets of records, using the classification technology of CreateTheme().
Syntax
sets = CreateGroup(string field_spec, string method, int num_classes, array options)
| Argument | Contents |
|---|---|
| field_spec | The field spec for the field on which the theme is based |
| method | The method used to generate the classes |
| num_classes | The number of classes you want to create |
For complete documentation of the methods and options to CreateGroup(), see CreateTheme().
Returns
An array of set names.
Notes
-
The arguments to CreateGroup() are similar to those of CreateTheme().
-
CreateGroup() does not actually create a theme on the layer.
-
One selection set is created for each theme class.
-
If method is specified as Categories and num_classes as null, then the function will create one set for each distinct value in the data field.
Example
// An income classification with eight classes
sets = CreateGroup("County.Income", "Quantiles", 8,)Error Codes
| Error Type | Meaning |
|---|---|
| NotFound | There is no current layer, or the specified field(s) do not exist on the current layer |
| Escape | The user interrupted scanning of the data |
| Error | An argument or option has the wrong type or the wrong number of values, or an error occurred while scanning the data |
See Also
| Function | Summary |
|---|---|
| CreateGroupByTheme() | Creates multiple selection sets of records, using an existing theme |
| CreateTheme() | Creates a color or pattern theme on the current layer |
| TestTheme() | Provides information on the classes created by a call to CreateTheme() |