AxInterop.MapWinGIS
Map component for visualization of vector, raster or grid data.
Here is a class diagram for the AxMap class:
\dot
digraph map_diagram {
nodesep = 0.3;
ranksep = 0.3;
splines = ortho;
node [shape= "polygon", peripheries = 1, fontname=Helvetica, fontsize=9, color = lightsalmon, style = filled, height = 0.3, width = 1.0];
map [ label="AxMap" URL="\ref AxMap"];
node [shape = "polygon", color = gray, peripheries = 3, style = filled, height = 0.2, width = 0.8]
img [ label="Image" URL="\ref Image"];
sf [ label="Shapefile" URL="\ref Shapefile"];
node [color = tan, peripheries = 1, height = 0.3, width = 1.0];
gp [ label="GeoProjection" URL="\ref GeoProjection"];
meas [ label="Measuring" URL="\ref Measuring"];
tiles [ label="Tiles" URL="\ref Tiles"];
fm [ label="FileManager" URL="\ref FileManager"];
se [ label="ShapeEditor" URL="\ref ShapeEditor"];
edge [ dir = "none", style = solid, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060", labeldistance = 0.6 ]
map -> sf [ URL="\ref AxMap.get_Shapefile()", tooltip = "AxMap.get_Shapefile()", headlabel = " n"];
map -> img [URL="\ref AxMap.get_Image()", tooltip = "AxMap.get_Image()", headlabel = " n"]
gp -> map [ URL="\ref AxMap.GeoProjection", tooltip = "AxMap.GeoProjection", taillabel = "1 "];
meas -> map [URL="\ref AxMap.Measuring", tooltip = "AxMap.Measuring", taillabel = "1 "]
tiles -> map [URL="\ref AxMap.Tiles", tooltip = "AxMap.Tiles", taillabel = "1 "]
fm -> map [URL="\ref AxMap.FileManager", tooltip = "AxMap.FileManager", taillabel = "1 "]
se -> map [URL="\ref AxMap.ShapeEditor", tooltip = "AxMap.ShapeEditor", taillabel = "1 "]
}
\enddot
Graph description\n\n
Here are groups of API members for AxMap class:
\dotfile mapgroups.dot
Graph description
Gets or sets the user defined cursor handle. The handle is a windows cursor handle.
Gets or sets the object of Tiles class associated with map.
\new490 Added in version 4.9.0
Gets FileManager object associated with map. The object is used by AxMap.AddLayerFromFilename methods.
\new491 Added in version 4.9.1
Gets or sets the background color of the map.
When using VB.NET the color is represented as a System.Drawing.Color.
When using VB 6 the color can be an OLE_COLOR or an integer representation of an RGB value.
Draws the content of the back buffer to specified device context.
If the size of the back buffer differ from the provided dimensions, the scaling of the buffer content will be made.
The handle of the device context.
The width of the resulting image.
The height of the resulting image.
The global callback is the interface used by MapWinGIS to pass progress and error events to interested applications.
.NET clients passing ICallback implementation to this property must make respective
class COM visible by setting ComVisible(true) attribute. In fact ComVisible(true) is set by default
for public classes, so it's enough to make sure that it isn't explicitly set to false for the class
or assembly where the class is defined. Otherwise InvalidCastException may occur at runtime.
\deprecated v4.9.3 Use GlobalSettings.ApplicationCallback instead.
Returns the handle of the window of map control.
The handle of window.
The key may be used by the programmer to store any string data associated with the object.
Retrieves the last error generated in the object.
Gets or sets the cursor used with the map. When using crsrUserDefined be sure to set a UDCursorHandle.
Gets or sets the value which indicates how the control adjust its content after the resizing operations.
Redraws all layers in the map if the map is not locked.
The same as AxMap.Redraw2(tkRedrawType.RedrawAll).
Resizes the map to the given width and height.
The new width of the control.
The new hight of the control.
Gets or sets a value which indicates whether the time of map redraw will be displayed on the screen.
Only times of full redraws when data layers are drawn anew are displayed.
\new48 Added in version 4.8
Shows tooltip near the mouse cursor.
Text of the tooltip.
The duration of tooltip display.
Gets or sets a boolean value which indicate whether control's version number will be displayed on the screen.
\new48 Added in version 4.8
Takes snap shot of the contents of the map within the bounds of the specified rectangle, returning an image of the results.
The bounds (rectangle) in map units to get the snapshot from.
An image of the contents of the map displayed inside the bounds of the specified rectangle.
Takes snap shot of the contents of the map and returns it as an image object.
The position of the layer which extents will be used for taking snapshot.
The amount of zoom.
The width of the resulting image.
An image of the contents of the map.
Takes snap shot of the contents of the map in the specified bounding box and returns it as an image object.
The x coordinate of the lower left corner of the extents.
The x coordinate of the top right corner of the extents.
The y coordinate of the top right corner of the extents.
The y coordinate of the lower left corner of the extents.
The width of the resulting image in pixels.
An image of the contents of the map.
Performs drawing of the map contents to the specified device context.
The handle of the device context.
The map extents to be drawn.
The width of the resulting image inShowVersionNumber pixels.
True on success and false otherwise.
Gets or sets version number of the control.
The set part of the property isn't supported.
Retrieves the error message associated with the specified error code.
The error code for which the error message is required.
The error message description for the specified error code.
Gets or sets tile provider for the map.
This property is a shortcut for AxMap.Tiles.Provider property.
Setting it to ProviderNone will change AxMap.Tiles.Visible property to false.
\new491 Added in version 4.9.1
Returns coordinate of the shapefile point closest to specified point on screen.
Tolerance in screen pixels. If no vertex is found within the tolerance, operation fails.
X coordinate on screen.
Y coordinate on screen.
X coordinate of the vertex (map coordinates).
Y coordinate of the vertex (map coordinates).
True on success.
\new491 Added in version 4.9.1
Loads tiles for the specified map extents.
Extents to load tiles for (in map coordinates).
The width of the canvas on which the extents will be rendered.
Arbitrary key, to distinguish this request from others in AxMap.TilesLoaded event.
Provider to load tiles from.
If tiles aren't already loaded in cache, the operation will be performed asynchronously.
Use AxMap.TilesLoaded event to be notified of it's completion. The main purpose: loading of tiles
for printing.
\new491 Added in version 4.9.1
Performs specific type of map redraw.
Type of redraw.
Different types of redraw are necessary for performance reasons. If it's known that
only a specific part of map content has changed there is no need to run the full rendering,
screen buffer can be used instead. According to the amount of content being redrawn the different
types can be ordered like this (from minimum to the full one):
RedrawMinimal -> RedrawSkipAllLayers -> RedrawSkipDataLayers -> RedrawAll.
Each subsequent type includes preceding types, so it's never necessary to call two types in a row.
If it's not clear which type of redraw is appropriate for particular situation,
start with the minimal one and then go to the subsequent types until the changes
which were made are rendered. Also if datasource being used are small it's easier to ignore this method
altogether and call AxMap.Redraw instead ( equivalent to AxMap.Redraw2(tkRedrawType.RedrawAll)).
\new491 Added in version 4.9.1
Gets list actions performed by user via interactive shape editor. Provides undo/redo capability.
\new493 Added in version 4.9.3
Gets an %Identifier object which holds settings of cmIdentify tools.
\new493 Added in version 4.9.3
Gets instance of shape editor class associated with map which stores data entered by interactive editing tools.
\new493 Added in version 4.9.3
\addtogroup map_interaction Map interaction
Here is a list of properties and methods which affect the way a user interacts with the map. This module is a part of the documentation of AxMap class.
\dot
digraph map_interaction {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Map Interaction" URL="\ref map_interaction"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Gets or sets a boolean value which indicate whether map will be redrawn in the course of panning operation.
The default value is false. Setting this value to true can improve the user experience but
decrease the performance in case large layers are displayed.
\new48 Added in version 4.8
Gets or sets the cursor mode for the map.
The cursor mode determines how the map handles mouse click events on the map. The only mode not handled by the map is cmNone.
Gets or sets zoom behaviour for the map control.
\new491 Added in version 4.9.1
Zoomes map to display selected shapes of the specified shapefile.
Layer handle of shapefile layer with selected shapes.
True on success.
If the layer isn't shapefile or there is no selected shapes in it, nothing will happen.
\new490 Added in version 4.9.0
Zooms map to specified zoom level of the active tile provider (Map.Tiles.Provider).
Zoom
True if the zooming took place.
\new491 Added in version 4.9.1
Zooms to World extents (-180.0; 180.0; -90.0; 90.0)
Projection should be specified for map in order for this methods to work.
True on success.
\new490 Added in version 4.9.0
Checks to see if the map is currently locked or not.
Locks the window so that any changes will not be displayed until it is unlocked.
This is very useful if you are making a large number of changes at once and don't want the map to be redrawn between each change.
The changes of drawing options in the related classes (Shapefile, Labels, etc.) won't cause the redraw of the map even if it's not locked.
The state of the lock mode.
Gets or sets a boolean value which indicates whether a wait cursor will be displayed on map redraw.
Gets or sets the speed of zooming with mouse wheel.
The default values is 0.5. The values in 0.1 - 10.0 range are accepted. The value 1.0 will turn off
the zooming by mouse wheel.
Gets or sets whether the map sends mouse down events.
Gets or sets whether the map sends mouse move events.
Gets or sets whether the map sends mouse up events.
Gets or sets a boolean value which indicates whether the map sends on draw back buffer events.
Gets or sets whether the map sends the SelectBoxDrag event.
Gets or sets whether the map sends the SelectBoxFinal event.
Gets or sets a boolean value which can affect the displaying of the context menus in client code by the right click.
Zooms the display in by the given factor.
The factor to zoom in by.
Zooms the display out by the specified factor.
The factor to zoom out by.
Gets or sets the factor by which to zoom the view of the map in or out.
Zooms the map display to the specified layer.
The handle of the layer to zoom to.
Zooms the map to the maximum extents of all loaded layers.
Layers which are not visible are still used to compute maximum extents.
Zooms the map to the maximum extents of all loaded visible layers.
Layers which are not visible are not used to compute maximum extents.
Zooms the map view to the previous extents if there are previous extents in the extents history.
Returns the number of extents left in the extents history after zooming to previous extents.
Zooms the map display to the specified shape in the shapefile contained by the specified layer.
The handle of the layer containing the shape to zoom to.
The index of the shape to zoom to.
Gets or sets a value indicating whether zoom bar will be displayed on the map.
Zoom bar can be displayed only if projection of the map is set. Zoom levels
depend upon tile of the current tile provider.
/see AxMap.TileProvider, AxMap.Projection
\new492 Added in version 4.9.2
Gets or sets a value indicating whether animation will be displayed zooming map in or out.
Default csAuto value will display animation only if there are no data layers
within visisble extents. Animation also won't be displayed if there are more than 4
zoom levels between current and target level.
\new492 Added in version 4.9.2
Gets or sets a value indicating whether animation will be displayed to simulate
inertia after panning operation.
Default csAuto value will display animation only if there are no data layers
within visisble extents.
\note Mouse panning is somewhat more tricky than the one with smartphone's touch screen,
so some practice may be needed to learn not to stop mouse motion before releasing the button )))
\new492 Added in version 4.9.2
Gets or sets a value indicating whether currently rendered tile buffer should be scaled
and reused during the next redraw.
\new492 Added in version 4.9.2
Gets or sets a value indicating whether the legacy 'hand' cursor should be used
for map panning rather than the standard 'NSEW' four-point cursor.
\new495 Added in version 4.9.5
Gets or sets the amount of information to be displayed in zoom bar tool tip.
\new492 Added in version 4.9.2
Gets or sets a style of zoom box, which is used to select a region with Zoom In tool.
\new492 Added in version 4.9.2
Gets or sets minimum zoom level to be used by zoom bar.
This property won't increase the number of available levels,
if certain levels aren't supported by the provider they still won't be displayed.
\new492 Added in version 4.9.2
Gets or sets maximum zoom level to be used by zoom bar.
This property won't increase the number of available levels,
if certain levels aren't supported by the provider they still won't be displayed.
\new492 Added in version 4.9.2
Gets or sets a value indicating whether to move the mouse click point to the center of the map
when using the Zoom In or Zoom Out tools.
The default value is False, indicating that the map is not recentered,
but instead keeps the click point at the mouse position and zooms around that point.
\new495 Added in version 4.9.5
Reverts the last operation performed by user in interactive shape editor.
This method is preferable over AxMap.UndoList.Undo since it can
also undo point added during creation of new shape, which are not registered in the undo list.
\new493 Added in version 4.9.3
\addtogroup map_serialization Map serialization
Here is a list of properties and methods to preserve the state of the map and particular layers. This module is a part of the documentation of AxMap class.
\dot
digraph map_serialization {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Map Serialization" URL="\ref map_serialization"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Serializes the layer settings to the string.
The serialized string will not include information about the data source. Therefore
the same options can later be applied to any data layer of the same type (either shapefile or image).
The handle of the layer.
The string with serialized layer settings.
\new48 Added in version 4.8
Restores the state of the layer from the string generated by AxMap.SerializeLayer().
The handle of the layer.
The string to restore values from.
True on success and false otherwise.
\new48 Added in version 4.8
Serializes map state to the string.
A value which indicates whether relative or absolute paths to data sources will be used.
The path to the base folder starting from which relative paths will be calculated.
The string with the serialized map state.
\new48 Added in version 4.8
Restores map state from the string generated by AxMap.SerializeMapState.
This method will remove all the existing layers and load the layers specified in the string.
The string with serialized state.
A boolean value which indicates whether layers or only options of the map control will restored.
The path to the base folder starting from which relative paths were calculated.
True on success and false otherwise.
\new48 Added in version 4.8
Applies to the layer a set of settings from file with the specified name.
The options will be loaded from the file with the name [LayerName].[OptionsName].mwsymb
The handle of the layer.
The name of the set of options.
The output string which will hold the description of the options stored in file.
True on success and false otherwise.
\new48 Added in version 4.8
Removes set of options for the layer with the specified name.
The options are stored in files with the name [LayerName].[OptionsName].mwsymb
The handle of the layer.
The name of the set of options.
True on success and false otherwise.
\new48 Added in version 4.8
Saves settings of the layer to the file.
The options are saved to the file with name [LayerName].[OptionsName].mwsymb
The handle of the layer.
The name which will be attached to the set of options.
A value which indicates whether the existing file will be overwritten.
The description associated with the set of options.
True on success and false otherwise.
\new48 Added in version 4.8
Loads the state of the map from the file created by AxMap.SaveMapState method.
The name of the file.
A callback object to return information about progress and errors.
True on success and false otherwise.
\new48 Added in version 4.8
Saves the state of the map to the specified file.
Use AxMap.LoadState for reverse operation.
The serialized state include:
- properties of the control;
- references to the layers;
- drawing options for the layers.
.
The name of the file.
A value which indicates whether absolute or relative paths should be used.
A value which indicates whether the exiting file will be overwritten.
True on success and false otherwise.
\new48 Added in version 4.8
\addtogroup map_layer_properties Layer properties
Here is a list of properties common to all data layers. This module is a part of the documentation of AxMap class.
\dot
digraph map_layer_properties {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Layer Properties" URL="\ref map_layer_properties"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Gets maximum zoom at which the layer will be displayed.
It's analogous to get_LayerMaxVisibleScale, only scale specified as zoom level
of the current tile provider (Map.Tiles.Provider).
\new491 Added in version 4.9.1
Sets maximum zoom at which the layer will be displayed.
Layer handle.
The new value of max zoom.
It's analogous to set_LayerMaxVisibleScale, only scale specified as zoom level
of the current tile provider (Map.Tiles.Provider).
\new491 Added in version 4.9.1
Gets filename of datasource for the specified layer.
Layer handle.
Filename of the layer including path.
\new490 Added in version 4.9.0
Gets minimum zoom at which the layer will be displayed.
It's analogous to get_LayerMinVisibleScale, only scale specified as zoom level
of the current tile provider (Map.Tiles.Provider).
\new491 Added in version 4.9.1
Sets minimum zoom at which the layer will be displayed.
Layer handle.
The new value of max zoom.
It's analogous to set_LayerMinVisibleScale, only scale specified as zoom level
of the current tile provider (Map.Tiles.Provider).
\new491 Added in version 4.9.1
Sets the description of the layer.
The information will be stored in .mwsymb file associated with data layer.
The handle of the layer.
The description of the layer.
\new48 Added in version 4.8
Gets the description of the layer from the associated .mwsymb file.
The handle of the layer.
The string with description.
\new48 Added in version 4.8
Gets the boolean value which indicates whether the layer will be displayed at all scales or only within the chosen range of scales.
The handle of the layer.
True in case the layer will be displayed between specified scales only.
\see AxMap.get_LayerMaxVisibleScale, AxMap.get_LayerMinVisibleScale
\new48 Added in version 4.8
Sets the boolean value which indicates whether the layer will be displayed at all scales or only within the chosen range of scales.
The handle of the layer.
True in case the layer will be displayed between specified scales only.
\see set_LayerMaxVisibleScale, set_LayerMinVisibleScale
\new48 Added in version 4.8
Gets a string associated with a layer in the map.
This string can be used to store any string data desired by the developer.
The handle for the layer for which the layer key is to be set.
The layer key for the specified layer in string format.
Sets a string associated with a layer in the map.
This string can be used to store any string data desired by the developer.
The handle of the layer.
The string to be associated with layer.
Returns labels associated with layer.
Labels can also be obtained by using Shapefile.Labels and Image.Labels.
The handle of the layer.
The labels associated with the layer.
\new48 Added in version 4.8
Sets the labels associated with the layer.
The handle of the layer.
The new instance of the Labels class to be associated with the layer.
\new48 Added in version 4.8
Gets the maximum scale at which the layer is visible on the map.
The handle of the layer.
The maximum visible scale for the layer.
\new48 Added in version 4.8
Sets the maximum scale at which the layer is visible on the map.
The handle of the layer.
The maximum visible scale for the layer.
\new48 Added in version 4.8
Gets the minimum scale at which the layer is visible on the map.
The handle of the layer.
The minimum visible scale for the layer.
\new48 Added in version 4.8
Sets the minimum scale at which the layer is visible on the map.
The handle of the layer.
The minimum visible scale for the layer.
\new48 Added in version 4.8
Gets the name of the specified layer.
The handle of the layer for which the name is to be set.
The layer name for the specified layer.
Sets the name of the specified layer.
The handle of the layer for which the name is to be set.
The name to be set for the layer.
Gets a boolean value which indicates whether the layer will be serialized by appropriate routines.
This property affects AxMap.SaveMapState, AxMap.SerializeMapState.
The handle of the layer.
True in case the layer will be excluded from serialization and false otherwise.
\new48 Added in version 4.8
Sets a boolean value which indicates whether the layer will be serialized by appropriate routines.
This property affects AxMap.SaveMapState, AxMap.SerializeMapState.
The handle of the layer.
True in case the layer will be excluded from serialization and false otherwise.
\new48 Added in version 4.8
Gets the visibility of the specified layer.
The handle of the layer for which the visibility is being set.
A boolean value representing whether the layer is to be visible or not.
Sets the visibility of the specified layer.
The handle of the layer for which the visibility is returned.
A boolean value representing whether the layer is to be visible or not.
Returns a color scheme for the specified layer.
The layer handle of the layer for which the coloring scheme is required
The color scheme for the specified layer
\addtogroup map_layer_management Layer management
Here is a list of properties and methods which allow to work with layers of the map. This module is a part of the documentation of AxMap class.
\dot
digraph map_layer {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Layer Management" URL="\ref map_layer_management"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Removes all data from the map and sets its properties to the default state.
\new491 Added in version 4.9.1
Adds layer from the specified datasource.
Additional information on failure can be obtained through AxMap.FileManager property.
Filename of datasource
Open strategy (fosAutoDetect the default recommended value).
A value indicating whether a new layer will be visible.
Handle of the newly added layer or -1 on failure.
\new491 Added in version 4.9.1
Adds a layer to the map.
In case of OgrDatasource all layers will be added to the map. For grid datasources
an instance of Image class created with Grid.OpenAsImage will be used for rendering.
The object to add to the map. The following types are supported:
Shapefile, Image, Grid, OgrLayer, OgrDatasource.
Sets whether the layer is visible after being added to the map.
Returns the integer handle for the layer added to the map.
Gets the handle of the layer at the given position in the map. Returns -1 if there is no layer at the specified position
The position of the layer for which the layer handle is required.
The layer handle for the layer at the specified position.
Gets the position of the specified layer in the map.
The layer handle of the layer for which the layer position is required.
The layer position of the specified layer in the map.
Moves a layer in the map from the initial position to a target position.
The initial position of the layer to be moved.
The final position of the layer being moved.
Moves the specified layer below all other layers.
The position of the layer to move to the bottom
Boolean value representing success when true, and failure when false.
Moves the specified layer down one layer in the map.
The position of the layer to be moved.
Boolean value representing success when true, and failure when false.
Moves the specified layer to the top of all other layers.
The position of the layer to be moved.
Boolean value representing success when true, failure when false.
Moves the specified layer up one layer in the map.
The initial position of the layer to be moved.
Boolean value representing success when true, failure when false.
Gets the number of layers loaded in the map.
Removes all layers from the map.
Changes the data source for the specified layer without its closing.
The new data source must be of the same type, i.e. either Shapefile or Image.
The handle of the layer.
The the name of the new data source.
Removes the specified layer from the map
The handle of the layer to be removed from the map.
Removes layer from the map without its closing.
Shapefile.Close or Image.Close won't be called while removing the layer.
The handle of the layer.
Gets image object associated with the layer.
This method along with AxMap.get_Shapefile() can used to substitute AxMap.get_GetObject().
The handle of the layer.
The reference to the image or NULL reference in case of invalid handle or wrong layer type.
\new48 Added in version 4.8
Replaces the image object associated with the layer.
The old image will not be closed.
The handle of the layer.
The new image object.
\new48 Added in version 4.8
Gets shapefile object associated with the layer.
This method along with AxMap.get_Image() can be used to substitute AxMap.get_GetObject().
The handle of the layer.
The reference to the shapefile or NULL reference in case of invalid handle or wrong layer type.
\new48 Added in version 4.8
Replaces the shapefile object associated with the layer.
The old shapefile will not be closed.
The handle of the layer.
The new shapefile object.
\new48 Added in version 4.8
Returns the layer object with the given handle. The object could be a Shapefile, Grid, or Image object.
For OGR layers this method will return underlying shapefile from OgrLayer.GetBuffer().
Use AxMap.get_OgrLayer to access instance of OgrLayer itself.
The handle of the layer to be retrieved.
A Shapefile, Grid, or Image object.
Gets instance of OGR layer object associated with the specified layer.
The handle of the layer.
OGR layer or null in case of invalid layer index or wrong layer type.
\new493 Added in version 4.9.3
Gets a value which indicates whether a layer is visible at current map scale.
Handle of the layer.
True in case the layer is visible.
The property checks whether or not the layer is hidden because of AxMap.LayerDynamicVisibility property.
However it doesn't check that the layer has any objects within the current map extents.
\new493 Added in version 4.9.3
\addtogroup map_drawing_layers Drawing layers
Here is a list of methods and properties to interact with the drawing layers of the map. This module is a part of the documentation of AxMap class.
\dot
digraph map_drawing_layers {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Drawing Layers" URL="\ref map_drawing_layers"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Replaces the labels associated with the drawing layer.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The new instance of the Labels class to associate with the layer.
Gets labels associated with the drawing layer.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The reference to the Labels class or NULL reference on the invalid handle.
Clears all the drawings on the drawing layer specified.
Drawing handle of the drawing layer for which all drawings are to be cleared.
Clears all drawings on all drawing layers. This method is slower than using ClearDrawing on a specific layer
Draws a circle on the last drawing layer created by NewDrawing
Center x coordinate for the circle to be drawn.
Center y coordinate for the circle to be drawn.
Radius in pixels of the circle to be drawn.
Color of the circle to be drawn. This is a UInt32 representation of an RGB color.
Boolean value which determines whether the circle will be drawn with a fill or not.
Draws a circle on the specified drawing layer.
The handle of the drawing layer created with AxMap.NewDrawing call.
Center x coordinate for the circle to be drawn.
Center y coordinate for the circle to be drawn.
Radius in pixels of the circle to be drawn.
Color of the circle to be drawn. This is a UInt32 representation of an RGB color.
Boolean value which determines whether the circle will be drawn with a fill or not.
Draws a line on the last drawing layer created using NewDrawing.
X coordinate of the first point used to draw the line
Y coordinate of the first point used to draw the line.
X coordinate of the second point used to draw the line.
Y coordinate of the second point used to draw the line.
Width of the line in pixels.
Color to draw the line with. This is a UInt32 representation of an RGB value.
Draws a line on the specified drawing layer.
The handle of the drawing layer created with AxMap.NewDrawing call.
X coordinate of the first point used to draw the line
Y coordinate of the first point used to draw the line.
X coordinate of the second point used to draw the line.
Y coordinate of the second point used to draw the line.
Width of the line in pixels.
Color to draw the line with. This is a UInt32 representation of an RGB value.
Draws a point on the last drawing layer created by NewDrawing.
The x coordinate of the point to draw
The y coordinate of the point to draw.
The size in pixels of the point to be drawn.
The color of the point to be drawn. This is a UInt32 representation of an RGB color.
Draws a point on the specified drawing layer.
The handle of the drawing layer created with AxMap.NewDrawing call.
The x coordinate of the point to draw
The y coordinate of the point to draw.
The size in pixels of the point to be drawn.
The color of the point to be drawn. This is a UInt32 representation of an RGB color.
Draws a polygon on the last drawing layer created using NewDrawing.
An array containing x-coordinates for each point in the polygon.
An array containing y-coordinates for each point in the polygon.
The number of points in the polygon.
The color to use when drawing the polygon. This is a UInt32 representation of an RGB color.
A boolean value representing whether the polygon is drawn with a fill or not.
Draws a polygon on the specified drawing layer.
The handle of the drawing layer created with AxMap.NewDrawing call.
An array containing x-coordinates for each point in the polygon.
An array containing y-coordinates for each point in the polygon.
The number of points in the polygon.
The color to use when drawing the polygon. This is a UInt32 representation of an RGB color.
A boolean value representing whether the polygon is drawn with a fill or not.
Draws a circle with custom outline width on the last drawing layer created by NewDrawing.
Center x coordinate for the circle to be drawn.
Center y coordinate for the circle to be drawn.
Radius in pixels of the circle to be drawn.
Color of the circle to be drawn. This is a UInt32 representation of an RGB color.
Boolean value which determines whether the circle will be drawn with a fill or not.
The width of the outline.
Draws a circle with custom outline width on the specified drawing layer.
The handle of the drawing layer created with AxMap.NewDrawing call.
Center x coordinate for the circle to be drawn.
Center y coordinate for the circle to be drawn.
Radius in pixels of the circle to be drawn.
Color of the circle to be drawn. This is a UInt32 representation of an RGB color.
Boolean value which determines whether the circle will be drawn with a fill or not.
The width of the outline.
Draws a polygon with custom width of outline on the last drawing layer created using NewDrawing.
An array containing x-coordinates for each point in the polygon.
An array containing y-coordinates for each point in the polygon.
The number of points in the polygon.
The color to use when drawing the polygon. This is a UInt32 representation of an RGB color.
A boolean value representing whether the polygon is drawn with a fill or not.
The width of the outline.
Draws a polygon with custom width of outline on the last drawing layer created using NewDrawing.
The handle of the drawing layer created with AxMap.NewDrawing call.
An array containing x-coordinates for each point in the polygon.
An array containing y-coordinates for each point in the polygon.
The number of points in the polygon.
The color to use when drawing the polygon. This is a UInt32 representation of an RGB color.
A boolean value representing whether the polygon is drawn with a fill or not.
The width of the outline.
Creates a new drawing layer on the map returning its handle.
Sets the coordinate system to use for the new drawing layer to be created. (ScreenReferenced
uses pixels in screen coordinates. SpatiallyReferenced uses projected map units.)
The handle for the new drawing layer in the map.
Gets the drawing key which may be used by the programmer to store any string for a drawing layer with specified handle.
The handle of the drawing layer.
The string associated with the layer.
Sets the drawing key may be used by the programmer to store any string for a drawing layer with specified handle.
The handle of the drawing layer.
The string associated with the layer.
Sets the boolean value which indicates whether the labels of the drawing layer are visible.
The handle of the drawing layer.
A boolean value which indicates whether the labels are visible.
Clears labels on the specified drawing layer.
The handle of the drawing layer returned by AxMap.NewDrawing method.
Gets a boolean value which indicates whether labels of the drawing layer are visible.
This property corresponds to the Labels.Visible property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True in case labels are visible and false otherwise.
Sets a boolean value which indicates whether labels of the drawing layer are visible.
This property corresponds to the Labels.Visible property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True in case labels are visible and false otherwise.
Draws a label on the current drawing layer.
Text of the label.
X coordinate, in either screen or map units depending on the parameters of AxMap.NewDrawing used to create the layer.
Y coordinate, in either screen or map units depending on the parameters of AxMap.NewDrawing used to create the layer.
Rotation angle in degrees.
Layer handle if the label was added successfully or -1 on failure.
\new493 Added in version 4.9.3
Draws a label on the specified drawing layer.
Handle of the layer.
Text of the label.
X coordinate, in either screen or map units depending on the parameters of AxMap.NewDrawing used to create the layer.
Y coordinate, in either screen or map units depending on the parameters of AxMap.NewDrawing used to create the layer.
Rotation angle in degrees.
Layer handle if the label was added successfully or -1 on failure.
\new493 Added in version 4.9.3
\addtogroup map_shapefile Shapefile visualization
Here is a list of properties for changing appearance of shapefile layer added to the map.
Consider the usage of ShapeDrawingOptions class to access wider set of options.
See Shapefile.DefaultDrawingOptions for details. This module is a part of the documentation of AxMap class.
\dot
digraph map_shapefile {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Shapefile visualization" URL="\ref map_shapefile"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Gets whether the specified layer is drawn with a fill. Only works on polygon shapefiles.
Handle of the layer for which the fill is to be set.
Gets whether the layer is being drawn with a fill or not.
Sets whether the specified layer is drawn with a fill. Only works on polygon shapefiles.
Handle of the layer for which the fill is to be set.
Sets whether the layer is drawn with a fill or not.
Gets whether the lines for the shapefile in specified layer are drawn.
Handle of the layer to test if it is being drawn with a lines or not.
Gets whether the layer is being drawn with lines or not.
Sets whether the lines for the shapefile in specified layer are drawn.
Handle of the layer for which the lines are to be set.
Sets whether the layer is drawn with lines or not.
Gets whether the points/vertices for the shapefile in specified layer are drawn.
Handle of the layer to test if it is being drawn with a points or not.
Gets whether the layer is being drawn with points or not.
Sets whether the points/vertices for the shapefile in specified layer are drawn.
Handle of the layer for which the points are to be set.
Sets whether the layer is drawn with points or not.
Gets the fill color for the specified layer. Only works on polygon shapefiles.
Handle of the layer for which the fill color is required.
Fill color for the polygon shapefile.
Sets the fill color for the specified layer. Only works on polygon shapefiles
Handle of the layer for which the fill color is to be set.
Fill color for the polygon shapefile. This is a System.UInt32 representation of an RGB color.
Gets the fill stipple for the specified layer. Only works on polygon shapefiles.
Handle of the layer for which the fill stipple is required.
Gets the fill stipple for the specified layer.
Sets the fill stipple for the specified layer. Only works on polygon shapefiles.
Handle of the layer for which the fill stipple is to be set.
Sets fill stipple for the specified layer.
Gets the percentage of fill transparency for the specified layer. Only works on polygon shapefiles.
Handle of the layer to get percentage of fill transparency.
Gets the percentage of fill transparency for the specified layer.
Sets the percentage of fill transparency for the specified layer. Only works on polygon shapefiles.
Handle of the layer for which the fill transparency is to be set.
Sets the percentage of fill transparency for the specified layer.
Gets the line color for the specified layer. Only works on shapefiles.
Handle of the layer for which the line color is required.
Line color for the polygon shapefile.
Sets the line color for the specified layer. Only works on shapefiles.
Handle of the layer for which the line color is to be set.
Line color for the polygon shapefile. This is a System.UInt32 representation of an RGB color.
Gets the line stipple for the specified layer. Only works on shapefiles.
Handle of the layer for which the line stipple is required.
Line stipple for the shapefile.
Sets the line stipple for the specified layer. Only works on shapefiles.
Handle of the layer for which the line stipple is required.
Line stipple for the shapefile.
Gets the line width for the specified layer. Only works on shapefiles.
Suggested values for line width: 1 - 5
Handle of the layer for which the line width is required.
Line width for the shapefile.
Sets the line width for the specified layer. Only works on shapefiles.
Suggested values for line width: 1 - 5
Handle of the layer for which the line width is to be set.
Line width for the shapefile.
Gets the point color for the specified layer. Only works on shapefiles
Handle of the layer for which the point color is required.
Point color for the polygon shapefile.
Sets the point color for the specified layer. Only works on shapefiles.
Handle of the layer for which the point color is to be set.
Point color for the polygon shapefile. This is a System.UInt32 representation of an RGB color.
Gets the line point/vertex size for the specified layer. Only works on shapefiles.
Gets or sets the line point/vertex size for the specified layer. Only works on shapefiles.
Point/vertex size for the shapefile.
Sets the line point/vertex size for the specified layer. Only works on shapefiles.
Handle of the layer for which the point/vertex size is to be set.
Point/vertex size for the shapefile.
Gets the line point type for the specified layer. Only works on shapefiles.
Handle of the layer for which the point type is required.
%Point type for the shapefile.
Sets the line point type for the specified layer. Only works on shapefiles.
Handle of the layer for which the point type is to be set.
%Point type for the shapefile.
Gets the color of the polygon stipple for shapefile layer.
This property corresponds to the ShapeDrawingOptions.FillHatchStyle property.
The handle of the shapefile layer.
The color of stipple.
Sets the color of the polygon stipple for shapefile layer.
This property corresponds to the ShapeDrawingOptions.FillBgTransparent property.
This property corresponds to the ShapeDrawingOptions.FillHatchStyle property.
The handle of the shapefile layer.
The color of stipple.
\see Shapefile.DefaultDrawingOptions
Gets a boolean value which indicates whether the background of fill stipple for polygon shapefile layer will be transparent.
This property corresponds to the ShapeDrawingOptions.FillBgTransparent property.
The handle of the shapefile layer.
True in case the background is transparent and false otherwise.
Sets a boolean value which indicates whether the background of fill stipple for polygon shapefile layer will be transparent.
This property corresponds to the ShapeDrawingOptions.FillBgTransparent property.
The handle of the shapefile layer.
True in case the background is transparent and false otherwise.
\addtogroup map_extents Max extents and zoom
Here is list of properties and methods that affect map extents and zoom level. This module is a part of the documentation of AxMap class.
\dot
digraph map_extents {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Map extents adn zoom" URL="\ref map_extents"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
Sets geographic extents for the map.
Longitude of center of the screen (degrees).
Latitude of center of the screen (degrees).
Width of displayed extents in kilometres.
Projection for the must be specified in order for this method to work.
True on success.
\new491 Added in version 4.9.1
Gets known extents.
Known extents to retrieve.
Extents object.
\new491 Added in version 4.9.1
Gets geographic extents of the map in decimal degrees.
For operation to succeed, projection must be set for the map (see AxMap.GeoProjection property).
Otherwise null will be returned.
\new490 Added in version 4.9.0
Sets geographic extents in decimal degrees for the map.
Geographic extents in decimal degrees.
True on success.
For operation to succeed, projection must be set for the map (see AxMap.GeoProjection property)
\new490 Added in version 4.9.0
Gets or sets latitude of the center of screen (in decimal degrees).
Map projection must be set in order for this property to work.
\new491 Added in version 4.9.1
Gets or sets longitude of the center of screen (in decimal degrees).
Map projection must be set in order for this property to work.
\new491 Added in version 4.9.1
Gets or sets the current zoom level for the map. It corresponds to the zoom level of current tile provider.
Map projection must be set in order for this property to work.
\new491 Added in version 4.9.1
Gets or sets known extents for the map.
Map projection must be set in order for this property to work.
\new491 Added in version 4.9.1
Gets or sets the current map scale.
The scale depends on the AxMap.MapUnits property. Number of pixels per logical inch and the size of window are used to
determine the size of the displaying device. The calculations represent the closest approximation as there is no way
to determine the physical size of displaying device. The operation of setting the new scale preserve the map coordinates
of the center point on the screen.
\new48 Added in version 4.8
Gets or sets the number of extents to cache in the extents history
Gets or sets the percentage of the view used to pad the extents of a layer when zooming to a layer or maximum extents.
Padding makes it so that there is a small border around the layer when you zoom to it.
Gets or sets the extents of the map using an Extents object.
If the given extents do not fit the aspect ratio of the map, the map will fit the given extents as well as possible.
\new495 Return value changed to IExtents in version 4.9.5
Gets or sets the extents of the map displayed by the control.
\addtogroup map_coordinates Map projection and coordinates
Here is list of properties and methods which are related to coordinate system, projection of map and units conversion.
This module is a part of the documentation of AxMap class.
\dot
digraph map_projection {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = khaki, width = 0.2, height = 0.2, style = filled]
gr [label="Max projection and coordianates" URL="\ref map_coordinates"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description\n\n
\anchor a_projection
\section proj1 A. Setting projection for the map.
No matter what type of GIS application you are going to write, the decision about map coordinate system and projection is one of the first to be made.
MapWinGIS provides the following options.
\dot
digraph projection_options {
splines = true;
ranksep = 0.15;
nodesep = 0.5;
node [shape = oval, peripheries = 1, fontname=Helvetica, fontsize=9, fillcolor = gray, color = "gray", style = filled, height = 0.3, width = 0.8];
render [ label="Choosing map projection"];
node [shape = "note", width = 0.3, height = 0.3, peripheries = 1 fillcolor = "khaki" ]
s1 [label=" Set projection manullay\l"];
s2 [label=" Grab projection from data\l"];
s3 [label=" Don't use projection at all\l"];
edge [dir = none, arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#808080" minlen=2 ]
render -> s1;
render -> s2;
render -> s3;
}
\enddot
Let's consider each of the approaches.
1. Settings projection manually. \n\n
It can be done using one of the following approaches:\n\n
a) AxMap.Projection property - provides only most common projections (Spherical Mercator, WGS84) but available in Properties Window of Form designer.
\code
axMap1.Projection = tkMapProjection.PROJECTION_WGS84;
\endcode
b) For all other projections - GeoProjection class and AxMap.GeoProjection property:
\code
var gp = new GeoProjection();
// one of the following methods can be used; see more in GeoProjection class
// - use projections provided by MapWinGIS enumerations:
gp.SetWgs84Projection(tkWgs84Projection.Wgs84_UTM_zone_22N);
gp.SetWellKnownGeogCS(tkCoordinateSystem.csNAD83);
// - EPSG code of coordinate system; in this example Pulkovo 1942(83) / 3-degree Gauss-Kruger zone 5; see wwww.spatialreference.org for EPSG codes
gp.ImportFromEPSG(2399);
// - importing from proj4 or WKT string; in this example proj4 string for Amersfoort / RD New projection for Netherlands
gp.ImportFromAutoDetect("+proj=sterea +lat_0=52.15616055555555 +lon_0=5.38763888888889 +k=0.9999079 +x_0=155000 +y_0=463000 +ellps=bessel +units=m +no_defs ");
// applying projection
axMap1.GeoProjection = gp;
\endcode
2. Grabbing coordinate system and projection from data.
\code
axMap1.GrabProjectionFromData = true; // default value
axMap1.AddLayerFromFilename(@"d:\some_shapefile.shp", tkFileOpenStrategy.fosVectorLayer, true);
\endcode
GeoProjection will be taken from the first layer added to the map which has metadata about projection. AxMap.GeoProjection property will be updated from this metadata.
When last layer is removed from map AxMap.GeoProjection property will be cleared (set to empty projection).
3. Don't specify coordinate system at all.\n
- AxMap.Projection property is equal to PROJECTION_NONE (the default value);
- map units should be set manually via AxMap.MapUnits;
- calculation of distance and area will use Euclidean geometry with no account to the shape of Earth;
- it won't be possible to display tiles from TMS servers.
To setup map to work without geoprojection use the code:
\code
axMap1.Projection = tkMapProjection.PROJECTION_NONE;
axMap1.GrabProjectionFromData = false;
axMap1.MapUnits = tkUnitsOfMeasure.umMeters; // or another, depending on the data you display
\endcode
\section proj2 B. Interaction with already set projection
To check that map actually has a projection:
\code
Debug.WriteLine("Map has projection:" + (axMap1.Projection != tkMapProjection.PROJECTION_NONE));
// or with mode details
Debug.WriteLine("Projection of the map: " + (axMap1.GeoProjection.IsEmpty() ? "None" : axMap1.GeoProjection.ExportToWKT());
\endcode
Another way to check whether map has geoprojection is to see how coordinates are displayed when AxMap.ShowCoordinates is set to cdmAuto.
In case decimal degrees are displayed (Lat/Lng) - map has geoprojection, if x/y pair is shown - no geoprojection was set.
All of these methods will result in updating AxMap.GeoProjection property. GeoProjection object assigned to map is protected from changes,
i.e. GeoProjection.IsFrozen = true. To change already assigned projection, a new instance of GeoProjection object must be created:
\code
// this one will fail, because projection is frozen
if (!axMap1.GeoProjection.ImportFromEPSG(2399))
{
Debug.WriteLine("Projection wasn't set: " + axMap1.GeoProjection.get_ErrorMsg(axMap1.GeoProjection.LastErrorCode));
}
// this one will succeed as a new GeoProjection instance is created by Clone method:
var gp = axMap1.GeoProjection.Clone();
if (gp.ImportFromEPSG(2399))
{
axMap1.GeoProjection = gp;
}
\endcode
Regardless of the method for settings projection MapWinGIS will update AxMap.MapUnits. IF coordinate system is geographic one umDecimalDegrees
will be set, otherwise umMeters. This will ensure that scalebar and measuring will work correctly.
\section proj3 C. Choosing projection
When making decision about coordinate system and projection consider:\n\n
1. Whether it's important to display tiles from online services. Most TMS servers use Shperical Mercator projection (EPSG:3857),
therefore to avoid distortions of tiles map projection should be set to GoogleMercator as well:
\code
axMap1.Projection = tkMapProjection.PROJECTION_GOOGLE_MERCATOR;
\endcode
\note See more details on the issue in description of Tiles class.\n\n
2. What data you plan to display and what projection it's using. It's possible to do a reprojection with:
- Utils.ReprojectShapefile for shapefiles;
- Utils.GDALWarp for images and grids.
But it should be considered whether it is worth the effort.
Starting from version 4.9.2. built-in projection mismatch testing is implemented + optional
transformation for shapefiles. See GlobalSettings.AllowProjectionMismatch, GlobalSettings.ReprojectLayersOnAdding.
@{
Gets measuring object associated with map.
\new491 Added in version 4.9.1
Gets or sets the units of measure for the map.
This units must be the same as the units of the datasources being displayed.
This method affects the calculation of map scale (see AxMap.CurrentScale).
\new48 Added in version 4.8
Converts pixel coordinates to projected map coordinates
The x pixel coordinate to be converted into the projected x map coordinate.
The y pixel coordinate to be converted into the projected y map coordinate
The projected x map coordinate is returned through this reference parameter.
The projected y map coordinate is returned through this reference parameter.
Gets the number of screen pixels per the decimal degree of the data.
The set part of this property isn't supported. The correctness of results depends on AxMap.MapUnits property.
\new48 Added in version 4.8
Converts projected map coordinates into screen pixel units
The projected x map coordinate to be converted into the x pixel coordinate.
The projected y map coordinate to be converted into the y pixel coordinate.
The pixel x coordinate is returned through this reference parameter
The pixel y coordinate is returned through this reference parameter.
Gets or sets a value indicating whether coordinates of the current mouse position will be displayed on map.
\new491 Added in version 4.9.1
Gets or sets a value which indicate whether scalebar will be displayed on the map.
\new490 Added in version 4.9.0
Gets or sets units to be displayed for map scalebar.
\new491 Added in version 4.9.1
Gets or sets a value indicating whether projection for will be taken from the first datasource added to it.
If set to true projection will be taken from the first layer added to the map which has a projection.
On removing the last layer projection of the map will be cleared (set to an empty one).
\new491 Added in version 4.9.1
Sets projection of the map. It providers 2 most commonly used coordinate system/projections to be easily set from Form Designer.
To set other projections initialize GeoProjection object manually and use AxMap.GeoProjection property.
\new491 Added in version 4.9.1
Gets or sets projection for map.
Projection layered set to map must not be changed, but rather a new instance
of GeoProjection should be created (GeoProjection.Clone) and set to the property.
This property must be set in order for certain functionality to work (tiles, for example).
\new490 Added in version 4.9.0
Converts projected map coordinates to decimal degrees (map projection must be specified for this method to work).
Projected X map coordinate.
Projected Y map coordinate.
Converted longitude in decimal degrees
Converted latitude in decimal degrees
True on success.
\new491 Added in version 4.9.1
Converts coordinates in decimal degrees to pixel coordinates (map projection must be specified for this method to work).
X screen coordinate.
Y screen coordinate.
Converted longitude in decimal degrees
Converted latitude in decimal degrees
True on success.
\new491 Added in version 4.9.1
Converts coordinates in decimal degrees to projected map coordinates (map projection must be specified for this method to work).
Longitude in decimal degrees.
Latitude in decimal degrees.
Resulting projected X map coordinate.
Resulting Projected Y map coordinate.
True on success.
\new491 Added in version 4.9.1
Converts pixel coordinates to decimal degrees (map projection must be specified for this method to work).
Longitude in decimal degrees.
Latitude in decimal degrees.
Converted X screen coordinate.
Converted Y screen coordinate.
True on success.
\new491 Added in version 4.9.1
Calculates area of polygon taking into account the shape of Earth.
For the time being only single-part polygons are accepted as input. Calculation are made using
GeographicLib.
Single part polygon shape defined in coordinates of map.
Area of shape in square meters or 0.0 if current map projection doesn't support transformation to WGS84.
\new493 Added in version 4.9.3
Calculates geodesic distance between 2 points defined in map coordinate system.
To calculate geodesic distance between 2 points in screen coordinates use AxMap.PixelToProj first.
Calculation are made using GeographicLib.
X coordinate of the first point.
Y coordinate of the first point.
X coordinate of the second point.
Y coordinate of the second point.
Distance between 2 points in meters 0.0 if current map projection doesn't support transformation to WGS84
\new493 Added in version 4.9.3
Calculates length of polyline or perimeter of polygon taking into account the shape of Earth.
For the time being only single-part shapes are accepted as input. Calculation are made using
GeographicLib.
Single part polygon or polyline shape defined in coordinates of map.
Length of polyline or perimeter of polygon in meters or 0.0 if current map projection doesn't support transformation to WGS84.
\new493 Added in version 4.9.3
\addtogroup map_events Map events
\dot
digraph map_events_graph {
splines = true;
node [shape= "polygon", fontname=Helvetica, fontsize=9, style = filled, color = palegreen, height = 0.3, width = 1.2];
lb [ label="AxMap" URL="\ref AxMap"];
node [shape = "ellipse", color = gray, width = 0.2, height = 0.2, style = filled]
gr [label="Map events" URL="\ref map_events"];
edge [ arrowhead="open", style = solid, arrowsize = 0.6, fontname = "Arial", fontsize = 9, fontcolor = blue, color = "#606060" ]
lb -> gr;
}
\enddot
Graph description
@{
This event is fired after the rendering of drawing layers. Handle of device context is passed to allow the user to implement custom drawing.
Handle of device context of screen buffer.
Minimum X coordinate of the rectangle being rendered.
Maximum X coordinate of the rectangle being rendered.
Minimum Y coordinate of the rectangle being rendered.
Maximum Y coordinate of the rectangle being rendered.
Passed by reference.
The value should be set to blnTrue in case some additional drawing is performed in client code.
This event is fired after the rendering of standard layers. Handle of device context is passed to allow the user to implement custom drawing.
Handle of device context of screen buffer.
Minimum X coordinate of the rectangle being rendered.
Maximum X coordinate of the rectangle being rendered.
Minimum Y coordinate of the rectangle being rendered.
Maximum Y coordinate of the rectangle being rendered.
Passed by reference.
The value should be set to blnTrue in case some additional drawing is performed in client code.
\new495 Added in version 4.9.5
This event is fired after interactive editing of shape is finished (AxMap.CursorMode is set to cmEditShape).
The type of editing operation that was performed.
Handle of the layer the shape being edited belongs to.
Index of the shape withing layer.
The common use of the event is set attributes of the shape, update its label or style.
The operation parameter can be one of the following values: uoAddShape, uoRemoveShape, uoEditShape.
This event is fired when background loading of data for OgrLayer.Finishes.
Unique Id of the loading task.
Handle of the layer the loading is peformed for.
Number of features within current map extents.
Number of features that were actually loaded.
The loading task may be finished without any features being loaded under the following circumstances:
- number of features within current extents is larger than GlobalSettings.OgrLayerMaxFeatureCount parameter;
- the extents of map have been changed since the loading was started so the data being loaded is no longer needed;
- there is a problem with accessing the datasource (e.g. lost network connection).\n
In case of failure, i.e. (numLoaded = 0) the event will be fired from background thread. In case
of success - from the main thread before the rendering of the loaded data.
This event is fired when background loading of data for OgrLayer starts.
Unique Id of the loading task,
which can be tracked down in BackgroundLoadingFinished to determine the results of the operation.
Handle of the layer loading starts for.
The event is fired after map extents change for each OgrLayer with OgrLayer.DynamicLoading proprety set to true,
when the layer doesn't have the necessary data in its buffer (OgrLayer.GetBuffer). The event can be used
to display some kind of loading indicator to notify the user that some data is still being loaded.
This event is fired before shape is deleted in interactive Shape Editor.
What element of shape (whole shape, part, single vertex) is to be deleted.
Passed by reference. To cancel the operation this value should be set to blnTrue.
This event is fired when shape (or some of its elements) is selected in Shape Editor (AxMap.CursorMode = cmEditShape)
and user presses Delete button. The common use of his event is to display a message box asking the user whether
the operation should be performed.
This event is fired before the rendering of drawing layers. Handle of device context is passed to allow the user to implement custom drawing.
Handle of device context of screen buffer.
Minimum X coordinate of the rectangle being rendered.
Maximum X coordinate of the rectangle being rendered.
Minimum Y coordinate of the rectangle being rendered.
Maximum Y coordinate of the rectangle being rendered.
Passed by reference.
The value should be set to blnTrue in case some additional drawing is performed in client code.
This event is fired before the rendering of standard layers. Handle of device context is passed to allow the user to implement custom drawing.
Handle of device context of screen buffer.
Minimum X coordinate of the rectangle being rendered.
Maximum X coordinate of the rectangle being rendered.
Minimum Y coordinate of the rectangle being rendered.
Maximum Y coordinate of the rectangle being rendered.
Passed by reference.
The value should be set to blnTrue in case some additional drawing is performed in client code.
\new495 Added in version 4.9.5
This event is fired before editing starts for particular shape (after user click on the shape when map cursor is set to cmEditShape).
Handle of the layer the shape was selected from.
Index of shape to be edited.
Passed by reference. Allows user to cancel the editing operations by setting the value to blnTrue.
The event is fired when current map tool asks for the layer to work with.
X coordinate of mouse click in map coordinates (if the event was triggered by mouse click).
Y coordinate of mouse click in map coordinates (if the event was triggered by mouse click).
Passed by reference. Handle of the layer to apply the tool to should be set.
LayerHadle parameter in most cases is initially set to -1, which means "layer not defined".
If this value is left unchanged the pending operation won't be preformed. Further details are provided
in description of particular tools.
The event is fired when user performs double click with left mouse button while cursor is within the map control.
This event is fired when the extents of the map change.
This event is fired when a user drags a file and drops it on the map.
The filename of the file dropped on the map.
This event is fired when a new layer has been added to the map.
Handle of the newly added layer.
This event is fired when a new layer has been added to the map and it has no metadata about its coordinate system and projection.
Handle of the layer.
Passed by reference. The value should be set to blnTrue to cancel the adding operation.
If this event is not handled then decision about the layer will be taken based on
the value of GlobalSettings.AllowLayersWithoutProjections property.
This event is fired when a layer has been removed from map.
Handle of the layer.
The value will be set to true in case layer removal is caused by AxMap.RemoveAllLayers call.
This event is fired after a layer was reprojected (its original projection was different from the map projection).
Handle of the layer.
True in case reprojection was peformed successfully. False
Automatic reprojection if peformed in case of projection mismatch for vector datasources.
Reprojected datasource will be represented by in-memory shapefile, no disk version will be saved automatically.
Raster datasource will be rejected without an attempt to reproject them.
The projection mismatch behavior is controlled by GlobalSettings.AllowProjectionMismatch,
GlobalSettings.ReprojectionLayerOnAdding properties.
This event is fired for each layer in the map when the map state is changed
Handle of the layer.
This event is fired after the user adds or removes a point from the path of measuring tool.
Particular action performed by user.
This event is fired when a user has pressed a mouse button while the cursor is inside the map control.
The map property SendMouseDown must be set to True for this event to be fired.
Mouse button that was pressed.
The shift/ctrl modifiers pressed during the creation of this event.
X coordinate of mouse cursor position in pixels relative to control's origin.
Y coordinate of mouse cursor position in pixels relative to control's origin.
This event is fired when the mouse is moved while the cursor is inside the map control.
The map property SendMoveMouse must be set to True for this event to be fired.
Mouse button that was pressed.
The shift/ctrl modifiers pressed during the creation of this event.
X coordinate of mouse cursor position in pixels relative to control's origin.
Y coordinate of mouse cursor position in pixels relative to control's origin.
This event is fired when the mouse button is released while the cursor is in the map control.
The map property SendMouseUp must be set to True for this event to be fired.
Mouse button that was pressed.
The shift/ctrl modifiers pressed during the creation of this event.
X coordinate of mouse cursor position in pixels relative to control's origin.
Y coordinate of mouse cursor position in pixels relative to control's origin.
This event is fired during the rendering of map after data layers and drawing layers were rendered.
The map property SendMouseUp SendOnDrawBackBuffer must be set to True for this event to be fired.
Handle of the device context of back buffer bitmap.
The event is fired when projection of the map control was changed.
This event is fired when a layer was added to the map with projection / coordinate system different from
those of the map control.
Handle of the layer.
Passed by reference. The value should be set to blnTrue in case the adding of the layer should be cancelled.
Passed by reference. The value should be set to blnTrue to instruct the control
to run automatic reprojection of the layer.
This event is fired while the user is dragging a selection box in the map control.
The map property SendSelectBoxDrag must be set to True for this event to be fired.
The left boundary of the selection box in pixel coordinates.
The right boundary of the selection box in pixel coordinates.
The bottom boundary of the selection box in pixel coordinates.
The top boundary of the selection box in pixel coordinates.
This event is fired when the user finishes dragging a selection box in the map control.
The map property SendSelectBoxFinal must be set to True for this event to be fired.
The left boundary of the selection box in pixel coordinates.
The right boundary of the selection box in pixel coordinates.
The bottom boundary of the selection box in pixel coordinates.
The top boundary of the selection box in pixel coordinates.
This event is fired after shapes were selected with cmSelection tool.
Handle of the layer the shapes were selected on.
The event will be fired only when selection is done by AxMap control internally, i.e.
- AxMap.CursorMode set to cmSelection;
- a layer handle is passed to AxMap.ChooseLayer event handler;
- user changes selection by clicking on shapes or drawing selection box.
When Shapefile.ShapeSelected property is changed from client code no event is fired.
This event is fired when mouse cursor is being moved by user and the cursor enters or leaves neighborhood of particular shape.
Handle of the layer the shape belongs to.
Index of the shape.
The event is fired when:
- AxMap.CursorMode is set to cmIdentify tool or one of the editing tools (cmAddShape, cmEditShape, etc.);
- number shapes within visible extents is smaller than GlobalSettings.HotTrackingMaxShapeCount.
For cmIdentify tool the shape will be automatically highlighted (see AxMap.Identifier for details);
For editing cursors vertices of the shape under cursor will be displayed (see ShapeEditor.HighlightVertices property).
This event is fired when user click on a shape with cmIdentify tool active.
Handle of the layer.
Index of the shape.
X coordinate of mouse click position in map coordinates.
Y coordinate of mouse click position in map coordinates
This event is fired when shape being created or edited has topological errors and therefore can't be saved to the layer.
Message about the reasons as to why the validation has failed.
This event is fired when complete set of tiles has been loaded for the new map extents.
True in case the loading of tiles was done as a part of making snapshot of the map.
A key of operation set in AxMap.LoadTilesForSnapshot method.
This event is fired when an operations is added or removed from undo/redo list of interactive Shape Editor.
This event is fired before a shape which is being created or edited is about to be saved back to the layer.
Handle of the layer.
Shape to be validated.
Passed by reference. This value should be set to blnTrue in case shape don't pass custom validation.
Shape Editor performs its own validation determined by ShapeEditor.ValidationMode, so there is
no need to run the same checks once again here (like Shape.IsValid). However is some form of custom
rules should be enforced, there is a right place to do it.
This event is fired after grid datasource was added to the map.
Handle of the layer.
The filename of the original datasource.
Index of band which is used for visualization.
Whether the datasource is rendered by Image class directly or
by using an RBG image that was created to serve as proxy.
Holds members that once were a part of %AxMap class.
New API members to substitute deprecated ones are listed in description.
Gets or sets line separation factor.
\deprecated v4.8. Use LinePattern class, and ShapeDrawingOptions.LinePattern property instead.
\removed493 Removed in v4.9.3
Gets one user defined stipple row.
The user defined fill stipple contains 32 rows of 32 bits. The stipple is created by
setting patterns in the bits contained in each row.
The handle of the layer for which the fill stipple is to be set.
The row in the custom stipple for which the pattern is to be set.
The custom fill stipple as an integer value where the stipple is defined
by arranging the 32 bits in desired pattern.
\deprecated v.4.8. Use ShapeDrawingOptions.FillHatchStyle instead.
\removed493 Removed in v4.9.3
Sets one user defined stipple row.
The user defined fill stipple contains 32 rows of 32 bits.
The stipple is created by setting patterns in the bits contained in each row.
The handle of the layer for which the fill stipple is to be set.
The row in the custom stipple for which the pattern is to be set.
The custom fill stipple as an integer value where the stipple is defined
by arranging the 32 bits in desired pattern
\deprecated v.4.8. Use ShapeDrawingOptions.FillHatchStyle instead.
\removed493 Removed in v4.9.3
Gets the user defined line stipple for the specified layer.
The user defined line stipple is represented by an Integer (VB.NET) or a Long (VB 6). The first digit represents the stipple
multiplier. Each of the following digits alternate between representing pixels drawn and pixels skipped in the pattern. The
number of pixels to be drawn or skipped are determined by multiplying the digit representing that segment of the stipple by
the stipple multiplier.\n
This custom line stipple would draw six pixels(2*3), skip eight pixels(2*4), draw ten pixels(2*5), skip twelve pixels(2*6), with
the pattern repeating from the beginning after that. The largest valid line stipple is 2147483647. Any value greater than this
will result in overflow. A line stipple value less than 111 will result in a solid line.
The handle of the layer for which the user defined shape line stipple is to be set.
The user defined line stipple.
\deprecated v.4.8. Use LinePattern class instead.
\removed493 Removed in v4.9.3
Sets the user defined line stipple for the specified layer.
The user defined line stipple is represented by an Integer (VB.NET) or a Long (VB 6). The first digit represents the stipple
multiplier. Each of the following digits alternate between representing pixels drawn and pixels skipped in the pattern. The
number of pixels to be drawn or skipped are determined by multiplying the digit representing that segment of the stipple by
the stipple multiplier.\n
This custom line stipple would draw six pixels(2*3), skip eight pixels(2*4), draw ten pixels(2*5), skip twelve pixels(2*6), with
the pattern repeating from the beginning after that. The largest valid line stipple is 2147483647. Any value greater than this
will result in overflow. A line stipple value less than 111 will result in a solid line.
The handle of the layer for which the user defined shape line stipple is to be set.
The user defined line stipple.
\deprecated v.4.8. Use LinePattern class instead.
\removed493 Removed in v4.9.3
Sets the font for point markers defined by font characters.
The handle of the layer.
The name of the font.
The size of the font.
A boolean value which indicates whether the font is bold.
A boolean value which indicates whether the font is italic.
A boolean value which indicates whether the font is underlined.
\deprecated v.4.8. Use ShapeDrawingOptions.PointCharacter and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Sets the font size for point markers defined by font characters.
The handle of the layer.
The size of the font.
\deprecated v.4.8. Use ShapeDrawingOptions.PointCharacter and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Adds a new item in the list of point markers defined by font characters
The handle of the layer.
The ANSI code of the new character.
The color of the marker.
The index of the new font character in the list of markers.
\deprecated v.4.8. Use ShapeDrawingOptions.PointCharacter and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Allows you to build an image list so that one point shapefile can have multiple icons.
The layer handle of the layer for which the image list is defined.
The Integer index for the image to retrieve
The image object which is used as the point image for the specified layer.
\deprecated v.4.8. Use ShapeDrawingOptions.Picture and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Gets the number of images currently stored in the image list for custom points images.
The layer handle of the layer for which the image list is defined.
The Count of images currently stored in the image index of custom point types for that layer.
Remember to subtract 1 from this count when indexing the 0 based image list.
\deprecated v.4.8. Use ShapeDrawingOptions.Picture and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Allows you to build an image list so that one point shapefile can have multiple icons.
The layer handle of the layer for which the image list is defined.
The Integer index for the image to retrieve
The image object which is used as the point image for the specified layer.
\deprecated v.4.8. Use ShapeDrawingOptions.Picture and ShapefileCategories instead.
\removed493 Removed in v4.9.3
Gets the image used when drawing points on the specified layer.
The layer handle of the layer for which the point type is required.
The image object which is used as the point image for the specified layer.
\deprecated v.4.8. Use ShapeDrawingOptions.PointType instead.
\removed493 Removed in v4.9.3
Sets the image used when drawing points on the specified layer.
The layer handle of the layer for which the point type is required.
The image object which is used as the point image for the specified layer.
\deprecated v.4.8. Use ShapeDrawingOptions.PointType instead.
\removed493 Removed in v4.9.3
Deprecated. Gets whether the specified shape is drawn with a fill. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill is to be set.
Handle of the shape for which the fill is to be set.
Sets whether the shape is drawn with a fill or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillVisible property. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets whether the specified shape is drawn with a fill. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill is to be set.
Handle of the shape for which the fill is to be set.
Sets whether the shape is drawn with a fill or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillVisible property. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets whether the lines for the specified shape are drawn.
Handle of the layer containing the shape for which the lines are to be set.
Handle of the shape for which the lines are to be set.
Sets whether the shape is drawn with lines or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineVisible instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets whether the lines for the specified shape are drawn.
Handle of the layer containing the shape for which the lines are to be set.
Handle of the shape for which the lines are to be set.
Sets whether the shape is drawn with lines or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineVisible instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets whether the points/vertices in specified shape are drawn.
Handle of the layer containing the shape for which the points are to be set.
Handle of the shape for which the points are to be set.
Sets whether the shape is drawn with points or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.Visible instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets whether the points/vertices in specified shape are drawn.
Handle of the layer containing the shape for which the points are to be set.
Handle of the shape for which the points are to be set.
Sets whether the shape is drawn with points or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.Visible instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the fill color for the specified shape. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill color is to be set.
Handle for the shape for which the fill color is to be set.
Fill color for the shape in the polygon shapefile. This is a System.UInt32 representation of an RGB color.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillColor instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the fill color for the specified shape. Only works on polygon shapefiles
Handle of the layer containing the shape for which the fill color is to be set.
Handle for the shape for which the fill color is to be set.
Fill color for the shape in the polygon shapefile. This is a System.UInt32 representation of an RGB color
\deprecated v. 4.8. Use ShapeDrawingOptions.FillColor instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the fill stipple for the specified shape. Only works on polygon shapefiles
Handle of the layer containing the shape for which the fill stipple is to be set.
Handle of the shape for which the fill stipple is required.
Gets the fill stipple for the specified shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillHatchStyle instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the fill stipple for the specified shape. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill stipple is to be set.
Handle of the shape for which the fill stipple is to be set.
Sets fill stipple for the specified shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillHatchStyle instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the percentage of fill transparency for the specified layer. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill transparency is to be set.
Handle of the shape for which the fill transparency is to be set.
Gets the percentage of fill transparency for the specified shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillTransparency instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the percentage of fill transparency for the specified layer. Only works on polygon shapefiles.
Handle of the layer containing the shape for which the fill transparency is to be set.
Handle of the shape for which the fill transparency is to be set.
Sets the percentage of fill transparency for the specified shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillTransparency instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the line color for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the line color is required.
Handle of the shape for which the line color is required.
Line color for the shape in the polygon shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineColor instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the line color for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the line color is to be set.
Handle of the shape for which the line color is to be set.
Line color for the shape in the polygon shapefile. This is a System.UInt32 representation of an RGB color
\deprecated v. 4.8. Use ShapeDrawingOptions.LineColor instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the line stipple for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the line stipple is required.
Handle of the shape for which the line stipple is required.
Line stipple for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineStipple instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the line stipple for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the line stipple is to be set.
Handle of the shape for which the line stipple is to be set.
Line stipple for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineStipple instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the line width for the specified shape. Only works on shapefiles.
Suggested values for line width: 1 - 5
Handle of the layer for which the line width is required.
Handle of the shape for which the line width is required.
Line width for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineWidth instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the line width for the specified shape. Only works on shapefiles.
Suggested values for line width: 1 - 5
Handle of the layer containing the shape for which the line width is to be set.
Handle of the shape for which the line width is to be set
Line width for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.LineWidth instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the point color for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point color is required.
Handle of the shape for which the point color is required.
Point color for the shape in the polygon shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillColor for point shapefiles and ShapeDrawingOptions.VerticesColor
for polylines and polygons instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the point color for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point color is to be set.
Handle of the shape for which the point color is to be set.
Point color for the shape in the polygon shapefile. This is a System.UInt32 representation of an RGB color
\deprecated v. 4.8. Use ShapeDrawingOptions.FillColor for point shapefiles and ShapeDrawingOptions.VerticesColor
for polylines and polygons instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the index of the point marker represented by font character.
The handle of the layer.
The index of the shape.
The index of the marker associated with shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointCharacter instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the index of the point marker represented by font character.
The handle of the layer.
The index of the shape.
The index of the marker associated with shape.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointCharacter instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Allows you specify an image from the image list so that one point shapefile can have multiple icons.
The layer handle of the layer for which the image list is defined.
The specific shape in the layer that you wish to determine the image index for
The index in the image list of user defined images.
\deprecated v. 4.8. Use ShapeDrawingOptions.Picture instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Allows you specify an image from the image list so that one point shapefile can have multiple icons
The layer handle of the layer containing the list to specify an image from.
The specific shape to be assigned a value in the layer.
The index of the image in the imagelist that you want to assign to the specified shape
\deprecated v. 4.8. Use ShapeDrawingOptions.Picture instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Gets the line point/vertex size for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point/vertex size is required.
Handle of the shape for which the point/vertex size is required
Point/vertex size for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointSize instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Sets the line point/vertex size for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point/vertex size is to be set.
Handle of the shape for which the point/vertex size is to be set.
Point/vertex size for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointSize instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the line point type for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point type is to be set.
Handle of the shape for which the point type is to be set.
Point type for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointType instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the line point type for the specified shape. Only works on shapefiles.
Handle of the layer containing the shape for which the point type is required.
Handle of the shape for which the point type is required.
Point type for the shape in the shapefile.
\deprecated v. 4.8. Use ShapeDrawingOptions.PointType instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the color of the polygon fill stipple for the given shape of the layer.
The handle of the layer.
The index of the shape.
The color of stipple.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillHatchStyle instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the color of the polygon fill stipple for the given shape of the layer.
The handle of the layer.
The index of the shape.
The color of stipple.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillHatchStyle instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets a boolean value which indicates whether the background of fill stipple for given shape of will be transparent.
The handle of the layer.
The index of the shape.
True in case the background is transparent and false otherwise.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillBgTransparent instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets a boolean value which indicates whether the background of fill stipple for given shape of will be transparent.
The handle of the layer.
The index of the shape.
True in case the background is transparent and false otherwise.
\deprecated v. 4.8. Use ShapeDrawingOptions.FillBgTransparent instead. See ShapefileCategories, Shapefile.set_ShapeCategory to setup
visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Gets the visibility of the specified shape.
Handle of the layer containing the shape for which the visibility is required.
Handle of the shape for which the visibility is required.
Boolean value representing whether the the shape is visible or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.Visible and Shapefile.VisibilityExpression instead.
See ShapefileCategories, Shapefile.set_ShapeCategory to setup visualization of individual shapes.
\removed493 Removed in v4.9.3
Deprecated. Sets the visibility of the specified shape.
Handle of the layer containing the shape for which the visibility is to be set
Handle of the shape for which the visibility is to be set.
Boolean value representing whether the shape is to be visible or not.
\deprecated v. 4.8. Use ShapeDrawingOptions.Visible and Shapefile.VisibilityExpression instead.
See ShapefileCategories, Shapefile.set_ShapeCategory to setup visualization of individual shapes.
\removed493 Removed in v4.9.3
Applies the coloring scheme to a layer (the layer handle is specified in the coloring scheme object).
Deprecated for shapefile layers.
The coloring scheme to apply.
Boolean value indicating the successful application when true, unsuccessful application when false.
\deprecated v4.9.3 No longer used.
\removed493 Removed in v4.9.3.
Returns a boolean value which indicates whether the specified file holds tiff grid.
The name of the file.
True on success and false otherwise.
\deprecated v4.9.3 Use Utils.IsTiffGrid instead.
\removed493 Removed in v4.9.3.
Gets or sets the drawing method for vector layers.
The default value is vdmNewSymbology. From the version 4.8 this is the only value supported.
\new48 Added in version 4.8
\deprecated v4.8 No longer used.
\removed493 Removed in v4.9.3
Sets a coloring scheme to be associated with an image layer.
The coloring scheme is for reference purposes only and has no effect the coloring or display of the image.
The handle of the image layer to attach the coloring scheme to.
The coloring scheme to attach to the specified image layer.
Boolean value representing success when true, failure when false.
\deprecated v4.8 Use Image.CustomColorScheme instead.
\removed493 Removed in v4.9.3
Updates the display of the specified image object.
The handle of the layer.
\deprecated v4.9.3 No longer used.
\removed493 Removed in v4.9.3
Gets or sets the filename of the Grid object associated with an Image object loaded into the map.
The handle of the layer for which the grid filename is to be set.
The grid filename to be associated with the specified layer.
\deprecated v 4.9.1 Use AxMap.get_Image, Image.SourceGridName instead.
\removed493 Removed in v4.9.3
Gets or sets the percentage of transparency of an Image layer.
The layer handle of the Image layer for which the transparency is to be set.
The percentage of transparency for the specified image layer.
\deprecated v4.9.3 Use AxMap.get_Image, Image.TransparencyPercent instead.
\removed493 Removed in v4.9.3
Sets the filename of the grid associated with the specified layer.
MapWinGIS will create a bitmap representation for the grid and use instance of Image class for display.
The layer handle.
The name of the file with grid.
\deprecated v 4.9.1 Use Image.SourceGridName instead.
\removed493 Removed in v4.9.3
Adds a label to the map.
The handle of the layer where the label will be added to.
The text to be used for the label.
The color of the added label. This is a UInt32 representation of an RGB color.
The x coordinate in projected map units which determines where the label will be added on the map.
The y coordinate in projected map units which determines where the label will be added on the map.
Specifies whether to justify the label's text right, left, or center.
\deprecated v.4.8 The method will ignore Color and hJustification parameters. Use Labels interface ( AxMap.get_LayerLabels ) to change these settings.
\removed493 Removed in v4.9.3
Adds an extended label to the map, allowing for rotated labels.
The handle of the layer where the label will be added to.
The text to be used for the label.
The color of the added label. This is a UInt32 representation of an RGB color.
The x coordinate in projected map units which determines where the label will be added on the map.
The y coordinate in projected map units which determines where the label will be added on the map.
Specifies whether to justify the label's text right, left, or center.
The number of degrees to rotate the label. Positive angles rotate the text counter-clockwise, and
negative angles rotate the text clockwise
\deprecated v.4.8 The method will ignore Color and hJustification parameters. Use Labels interface ( AxMap.get_LayerLabels ) to change these settings.
\removed493 Removed in v4.9.3
Clears all labels that have been added to the specified layer.
Handle of the layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.Clear instead.
\removed493 Removed in v4.9.3
Gets the offset for the labels on the layer.
The offset is the distance in pixels from the label point to the text.
The handle of the layer for which the offset is to be set.
The offset for the labels on the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.OffsetX, Labels.OffsetY instead.
\removed493 Removed in v4.9.3
Sets the offset for the labels on the layer.
The offset is the distance in pixels from the label point to the text.
The handle of the layer for which the offset is to be set.
The offset for the labels on the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.OffsetX, Labels.OffsetY instead.
\removed493 Removed in v4.9.3
Gets whether to scale the labels on the layer.
The handle of the layer for which the scaling of labels is to be set.
A boolean value representing whether or not to scale the labels on the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.ScaleLabels instead.
\removed493 Removed in v4.9.3
Sets whether to scale the labels on the layer
The handle of the layer for which the scaling of labels is to be set.
A boolean value representing whether or not to scale the labels on the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.ScaleLabels instead.
\removed493 Removed in v4.9.3
Gets whether to use shadows for the labels on the layer.
The handle of the layer for which the use of label shadows is to be set.
A boolean value representing whether or not label shadows will be used for the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.HaloVisible instead.
\removed493 Removed in v4.9.3
Sets whether to use shadows for the labels on the layer.
The handle of the layer for which the use of label shadows is to be set.
A boolean value representing whether or not label shadows will be used for the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.HaloVisible instead.
\removed493 Removed in v4.9.3
Gets the shadow color for the labels on the layer
The handle of the layer for which the shadow color is to be set.
The color to use the shadow color of the specified layer.
This is a System.UInt32 representation of an RGB color.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.HaloColor instead.
\removed493 Removed in v4.9.3
Sets the shadow color for the labels on the layer.
The layer handle of the layer for which the shadow color is to be set.
The color of use as the shadow color of the specified layer.
This is a System.UInt32 representation of an RGB color.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.HaloColor instead.
\removed493 Removed in v4.9.3
Gets label visibility for the specified layer.
The handle for the layer for which its label's visibility are to be set.
A boolean value which determines whether the specified layer's labels are visible or not.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.Visible instead.
\removed493 Removed in v4.9.3
Sets label visibility for the specified layer.
The layer handle for the layer for which its label's visibility are to be set.
A boolean value which determines whether the specified layer's labels are visible or not.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.Visible instead.
\removed493 Removed in v4.9.3
Gets the standard view width used to scale the labels on the layer
The handle of the layer for which the standard view width is required.
Reference parameter. The standard view width for the specified layer is returned through this parameter.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.BasicScale instead.
\removed493 Removed in v4.9.3
Sets the standard view width used to scale the labels on the layer.
The handle of the layer for which the standard view width is to be set.
The new standard view width for the specified layer.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.BasicScale instead.
\removed493 Removed in v4.9.3
Gets a boolean value which indicates whether overlapping labels will be allowed for the layer.
The handle of the layer.
True in case overlapping labels will be prevented and false otherwise.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.AvoidCollisions instead.
\removed493 Removed in v4.9.3
Sets a boolean value which indicates whether overlapping labels will be allowed for the layer.
The handle of the layer.
True in case overlapping labels will be forbidden and false otherwise.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.AvoidCollisions instead.
\removed493 Removed in v4.9.3
Sets the color of the font for labels of the layer.
The handle of the layer.
The color of the labels font.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.FontColor instead.
\removed493 Removed in v4.9.3
Sets the font to use when drawing labels for a layer.
Layer handle of the layer for which the label fonts are to be set.
Name of the font to use for the labels. (Ex: "Arial")
Size of the font to use for the labels.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.FontName, Labels.FontSize instead.
\removed493 Removed in v4.9.3
Sets the font for labels of the layer.
The handle of the layer.
The name of the font.
The size of the font.
A boolean value which indicates whether the font is bold.
A boolean value which indicates whether the font is italic.
A boolean value which indicates whether the font is underlined.
\deprecated v4.9.3 Use AxMap.get_LayerLabels, Labels.FontName, Labels.FontSize, Labels.FontBold, Labels.FontItalic, Labels.FontUnderline instead.
\removed493 Removed in v4.9.3
Gets or sets a boolean value which indicates whether multiline labels will be drawn correctly on the map.
\deprecated v 4.8. Multiline labels will be drawn after specification of appropriate label expression.
\see Labels.Expression.
\removed493 Removed in v4.9.3
Adds label to the specified drawing layer.
This method corresponds to the Labels.AddLabel method.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The text of the label.
The color of the label.
The x coordinate of the label.
The y coordinate of the label.
The justification of the label.
\deprecated v4.9.3 Use AxMap.DrawLabel, AxMap.DrawLabelEx instead.
\removed493 Removed in v4.9.3
Adds label to the specified drawing layer. Angle of rotation is accepted.
This method corresponds to the Labels.AddLabel method.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The text of the label.
The color of the label.
The x coordinate of the label.
The y coordinate of the label.
The justification of the label.
The angle of rotation in degrees.
\deprecated v4.9.3 Use AxMap.DrawLabel, AxMap.DrawLabelEx instead.
\removed493 Removed in v4.9.3
Gets the value which affects the scaling of labels.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The standard width of the view in pixels to use normal size of labels.
\deprecated v 4.8. Use AxMap.get_DrawingLabels, Labels.BasicScale instead.
\removed493 Removed in v4.9.3
Gets the vertical offset of the labels for the specified drawing layer in pixels.
The index of the drawing layer returned by AxMap.NewDrawing method.
The offset in pixels.
\deprecated v. 4.8. Use AxMap.get_DrawingLabels and Labels.OffsetX, Labels.OffsetY instead.
\removed493 Removed in v4.9.3
Sets the vertical offset of the labels for the specified drawing layer in pixels.
The index of the drawing layer returned by AxMap.NewDrawing method.
The offset in pixels.
\deprecated v. 4.8. Use AxMap.get_DrawingLabels and Labels.OffsetX, Labels.OffsetY instead.
\removed493 Removed in v4.9.3
Gets a boolean value which indicates whether the labels of the drawing layer will be scaled.
This property corresponds to the Labels.ScaleLabels property.
he index of the drawing layer returned by AxMap.NewDrawing method.
True if the labels are scaled and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.ScaleLabels instead.
\removed493 Removed in v4.9.3
Sets a boolean value which indicates whether the labels of the drawing layer will be scaled.
This property corresponds to the Labels.ScaleLabels property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True if the labels are scaled and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.ScaleLabels instead.
\removed493 Removed in v4.9.3
Gets a boolean value which indicates whether a shadow will be displayed for the labels of the drawing layer.
This property corresponds to the Labels.HaloVisible property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True if the shadow is displayed and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.HaloVisible instead.
\removed493 Removed in v4.9.3
Sets a boolean value which indicates whether a shadow will be displayed for the labels of the drawing layer.
This property corresponds to the Labels.HaloVisible property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True if the shadow is displayed and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.HaloVisible instead.
\removed493 Removed in v4.9.3
Gets the color of the shadow for the labels of the specified drawing layer.
This property corresponds to the Labels.HaloColor property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The color of shadow.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.HaloColor instead.
\removed493 Removed in v4.9.3
Sets the color of the shadow for the labels of the specified drawing layer.
This property corresponds to the Labels.HaloColor property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The color of shadow.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.HaloColor instead.
\removed493 Removed in v4.9.3
Gets a boolean value which indicates whether overlapping labels will be allowed for drawing layer.
This property corresponds to the Labels.AvoidCollisions property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True in case overlapping labels are removed and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.AvoidCollisions instead.
\removed493 Removed in v4.9.3
Sets a boolean value which indicates whether overlapping labels will be allowed for drawing layer.
This property corresponds to the Labels.AllowCollisions property.
The handle of the drawing layer returned by AxMap.NewDrawing method.
True in case overlapping labels are removed and false otherwise.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.AvoidCollisions instead.
\removed493 Removed in v4.9.3
Sets the font for the labels of the drawing layer.
The handle of the drawing layer returned by AxMap.NewDrawing method.
The name of the font.
The size of the font.
\deprecated v 4.9.3 Use AxMap.get_DrawingLabels, Labels.FontName, Labels.FontSize instead.
\removed493 Removed in v4.9.3
Gets or sets the angle of map rotation in degrees.
\deprecated v.4.9.3 The functionality is no longer supported.
\removed493 Removed in v4.9.3
Sets the numeric value which determines the transparency of the given image layer.
It is recommended to the properties of the Image class directly.
The handle of the layer with the image.
The value ranging from 0.0(transparent) to 1.0(opaque).
\deprecated v4.9.3 Use AxMap.get_Image(), Image.TransparencyPercent instead.
\removed493 Removed in v4.9.3
Deprecated. Affects the scaling of the labels of the specified drawing layer.
The handle of the drawing layer.
The width in pixels.
\deprecated v.4.8. Use AxMap.get_DrawingLabels, Labels.BasicScale and Labels.ScaleLabels instead.
\removed493 Removed in v4.9.3
Clears the images from the user defined list of point symbols.
The handle of the layer.
\deprecated v4.9.3 Use ShapeDrawingOptions.Picture instead.
\removed493 Removed in v4.9.3
Gets or set the point which is used as a center of the map rotation/
The x coordinate of the rotation point in map units.
The y coordinate of the rotation point in map units.
The base point for rotation.
\new48 Added in version 4.8
\deprecated v.4.9.3 The functionality is no longer supported.
\removed493 Removed in v4.9.3
Gets the bounding box which holds the extents of the map when rotation is applied.
The bounding box is equal to the map extents when rotation angle is 0 and larger than
map extents if the angle differs from it.
The bounding box of the rotated extents.
\new48 Added in version 4.8
\deprecated v.4.9.3 The functionality is no longer supported.
\removed493 Removed in v4.9.3
Tests the identity of 2 projections.
The first projection string.
The second projection string.
\deprecated v4.9.3 Use GeoProjection.get_IsSame, GeoProjection.get_IsSameExt instead.
\removed493 Removed in v4.9.3
Gets or sets a boolean value which indicates how images with identical size and position on the map will be drawn.
When set to true such images will be merged into a single bitmap. This may improve performance
in case of low number of data pixels (those which differ from the transparent color). The default value is false.
\new48 Added in version 4.8
\deprecated v.4.9.3 The functionality is no longer supported.
\removed493 Removed in v4.9.3
Gets or sets whether or not the map uses double buffering.
Double buffering uses a little more memory, but allows the view to be smoother with less flickering.
The default value is true. It's not recommended to change it.
\deprecated v.4.9.3 Double buffer is used in all cases.
\removed493 Removed in v4.9.3
Gets or sets the MapState string which stores all information needed to restore a view.
This includes layer information and coloring schemes.
\deprecated v.4.8 Use AxMap.SerializeMapState instead.
\removed493 Removed in v4.9.3
Serial number functionality is deprecated as MapWindow is now Open Source. This property may be left unset.
\deprecated v4.8 This property is no longer used.
\removed493 Removed in v4.9.3
Deprecated. Updates the extents of the layer before the drawing.
The handle of the layer.
True on success and false in case of invalid layer handle.
\deprecated v.4.8. The call is incorporated into drawing routine.
\removed493 Removed in v4.9.3
Justification of the labels
Shape drawing method