SetSetScale()
Summary
Sets the range of Scales at which a selection set displays (autoscale).
Syntax
SetSetScale(string set, double min_scale, double max_scale)
| Argument | Contents |
|---|---|
| set | The name of the selection set |
| min_scale | The minimum scale at which the layer displays |
| max_scale | The maximum scale at which the layer displays |
Notes
-
SetSetScale() applies autoscaling to a selection set in the current layer; the autoscale parameters for a selection set can vary from map to map.
-
If the min_scale is null, the selection set displays at any scale less than the max_scale. If the max_scale is null, the selection set displays at any scale greater than the min_scale. If both are null, the selection set displays at any scale.
-
Otherwise, the selection set displays only when it is part of a map whose scale falls in the specified range. When the scale of the map is outside the scale of the selection set, the selection set is automatically hidden.
-
The min_scale and max_scale are the denominators in the scale ratio; that is, to set a selection set to display between 1:1000 and 1:200,000, set min_scale to 1000 and max_scale to 200,000. Min_scale should always be less than max_scale.
-
Auto scale rulesets are too detailed to be useful when viewed at a small scale, or too coarse to be useful when viewed at a large scale.
-
The Selection selection set cannot be autoscaled.
Example
// Set manhole cover points selection set to display only between 1:1000 and 1:200,000
SetSetScale("Manholes", 1000, 200000)
// Set zones selection set to display at any scale
SetSetScale("Zones", null, null)Error Codes
| Error Type | Meaning |
|---|---|
| NotFound | The specified selection set does not exist |
See Also
| Function | Summary |
|---|---|
| GetLayerAutoscale() | Determines whether a layer is hidden in the current map due to autoscaling |
| GetLayerScale() | Gets the range of scales at which a layer displays (autoscale) |
| GetSetScale() | Sets the range of scales at which a selection set displays (autoscale) |
| SetLayerScale() | Sets the range of scales at which a layer displays (autoscale) |
| SetScale() | Sets the scale of a map |