SetLayerVisibility()
Summary
Set whether a layer is visible (displayed) in a map.
Syntax
SetLayerVisibility(string map_bar_layer, string visibility)
| Argument | Contents |
|---|---|
| map_bar_layer | The name of the map and layer |
| visibility | "True" if the specified layer is shown, otherwise "False" |
Notes
-
If map_bar_layer is null, SetLayerVisibility() affects the current layer in the current map.
-
If map_bar_layer is a layer name, SetLayerVisibility() affects the current map.
-
Even if a layer is visible, the autoscale settings for the layer may cause it not to be displayed at the current map scale.
-
SetLayerScaleFlag() turns autoscaling on or off for a layer without clearing the autoscale settings from the layer, and GetLayerScaleFlag() gets the autoscale flag for a layer. Make sure that the flag is "True" to have autoscaling active for a layer.
Example
// Make States visible but Counties hidden
SetLayerVisibility("States", "True")
SetLayerVisibility("Counties", "False")
// Make States visible in one map, but not the other
SetLayerVisibility("Map #1|States", "True")
SetLayerVisibility("Map #2|States", "False")Error Codes
| Error Type | Meaning |
|---|---|
| NotFound | The specified layer does not exist or is not in the specified map |
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) |
| GetLayerScaleFlag() | Gets the autoscale flag for a layer |
| GetLayerVisibility() | Determine whether a layer is visible (displayed) in a map |
| SetLayerScale() | Sets the range of scales at which a layer displays (autoscale) |
| SetLayerScaleFlag() | Sets the autoscale flag for a layer |
| SetDisplayStatus() | Changes how features in a selection set are displayed on a map |