Maptitude GISDK Help |
Sets the label override settings for a map feature.
Added to Version 6.0/2012.
SetLabelOverride(string layer_name, integer id, array settings)
Argument |
Contents |
layer_name |
The name of the layer |
integer id |
The ID of the map feature |
settings |
An options array with any of the following options |
Option |
Type |
Contents |
Alignment |
String |
Desired label position relative to the feature, expressed as a compass direction ("NW", "N", "NE", "W", "C", "E", "SW", "S," "SE") or "Auto" for automatic positioning |
Callout Flag |
Boolean |
If "'True" then draw a callout for this label if it is in a custom location; the default is "False" |
Callout Color |
Color |
Color of the callout line |
Callout Line Style |
Linestyle |
Style of the callout line |
Callout Style |
Integer |
1=straight line, 2=straight line with vertical bar, 3=bent line, or 4=bent line with vertical bar, corresponding to the four styles displayed on the callout tab |
Callout Width |
Real |
Width of the callout line |
Color |
Color |
Custom color for the label |
Font |
String |
Font name, size, and style for the label |
Force Display |
Boolean |
If "'True" then give the label top priority for display; the default is "False" |
Location |
Coord |
Custom location of the label; null to use the default position |
Slope |
Real |
A value between -90 and 90 to specify the slope of the label |
Suppress Display |
Boolean |
If "'True" then prevent display of a label; the default is "False" |
// Open a map and use a tool to customize a label
opts = GetSelectedLabel()
settings = null
settings.Slope = 45.
SetLabelOverride(opts.Layer, opts.ID, settings)
Error Type |
Meaning |
NotFound |
The specified layer or map feature does not exist |
Function |
Summary |
Allows the user to move, with optional callouts, or rotate labels on the map to customize them |
|
Gets the status of whether labels that are otherwise hidden are displayed in a lighter shading |
|
Gets the label override settings for a map feature |
|
Returns the layer name and ID of the last label clicked on |
|
Sets the status of whether labels that are otherwise hidden are displayed in a lighter shading |
©2025 Caliper Corporation | www.caliper.com |