DotSpatial.Symbology

This class contains two separate layers. The first is the BackImage where features that don't change over time are drawn. This way if heavy calculations are required to draw the background, you don't have to re-draw the background over and over again every time a sprite moves. The Front image is for small sprites that change rapidly, but

The real world extents for the entire buffer

The image being shown

Creates a new BackBuffer bitmap that is the specified size.

The width of the bitmap The height of the bitmap

Clears the back buffer.

Calculates a system.Drawing rectangle that corresponds to the specified real world envelope if it were drawn in pixels on the background image.

Fires the ExtentsChanged event

Occurs after something changes the geographic extents. This refers to the outer geographic extents, not the view extents.

Gets or sets the geographic extents for the entire back buffer.

Gets the graphics drawing surface for the BackBuffer

Gets or sets the height of this backbuffer in pixels

Gets or sets the actual Bitmap being used as the back buffer.

Boolean, true if the current thread is different from the original thread, indicating that cross-threading is taking place.

Gets or sets the width of the back buffer in pixels. This will copy the old back buffer to a new bitmap with the new width/height

Obtains a graphics object already organized into world coordinates. The client rectangle and world coordinates are used in order to determine the scale and translation of the transform necessary in the graphics object.

The envelope bounds in geographic coordinates.

BitmapFormatException

An EventArgs specifically tailored to ColorCategory.

Initializes a new instance of the ColorCategoryEventArgs class.

The IColorCategory that is involved in this event.

Gets the ColorCategory associated with this event.

An EventArgs specifically tailored to DynamicVisibilityMode.

Initializes a new instance of the DynamicVisibilityModeEventArgs class.

The item that supports IDynamicVisibility.

Gets the item that supports dynamic visibility.

Extension methods for extent that are related to System.Drawing, and not data.

This method assumes that there was a direct correlation between this envelope and the original rectangle. This reproportions this window to match the specified newRectangle.

The original envelope The original rectangle The new rectangle A new IEnvelope

Feature Set Apply Edit Args.

Initializes a new instance of the FeatureSetApplyEditArgs class.

The IFeatureSet edit copy. The delegate should point to a method handler to work with the edit copy.

Invokes the method that will handle changes using the EditCopy.

Gets or sets a duplicate of the IFeatureSet being referenced so that changes might be applied.

Defines the structure of the method that would handle the actual changes for an apply changes request.

The IFeatureSet edit copy being manipulated.

This interface provides ability to use in ColorCategory any custom actions (including GUI-dependent dialogs)

Show edit dialog

Instance of ColorCategory

An shared interface for members that wish to set dynamic visiblity.

Dynamic visibility represents layers that only appear when you zoom in close enough. This value represents the geographic width where that happens.

This controls whether the layer is visible when zoomed in closer than the dynamic visiblity width or only when further away from the dynamic visibility width

Gets or sets a boolean indicating whether dynamic visibility should be enabled.

This interface provides ability to use in FeatureLayer any custom actions (including GUI-dependent dialogs)

Show properties

Feature layer

Show Join Excel

Feature set

Show dynamic visibility dialog

Dynamic visibility

Show label setup dialog

Label layer

Show attributes dialog

Feature layer

Show export dialog

Feature layer

This interface provides ability to use in ImageLayer any custom actions (including GUI-dependent dialogs)

Show properties dialog

Image layer

Show export dialog

Image data

This interface provides ability to use in Layer any custom actions (including GUI-dependent dialogs)

Show Dynamic Visibility dialog

Dynamic Visibility

An EventArgs specifically tailored to ImageLayerEventArgs.

Initializes a new instance of the ImageLayerEventArgs class.

The IImageLayer that is involved in this event.

Gets the ImageLayer associated with this event.

CantBeDeletedException

Creates a new instance of CantBeDeletedException

Category

LegendItem

Descriptors are simple classes that are used for storing symbology or other basic characteristics. They are presumed to be made up of value types and other descriptors, and are expected to be serializable. This being said, some basic capabilities are supported for randomizing, copying and comparing the properties of descriptors.

CopyBase

Creates a new instance of CopyBase

Creates a duplicate of this descriptor using MemberwiseClone

A clone of this object as a duplicate

PropertyInfo returns overridden members as separate entries. We would rather work with each members only one time.

All the properties, including duplicates created by overridden members An Array of PropertyInfo members

This occurs during the Copy method and is overridable by sub-classes

The duplicate descriptor

IDescriptor

Matching is defined as being a different object, but having properties that would make it indistinguishable from the comparision property. This is an alternative to overriding the equals behavior in cases where you might ALSO need to see if the object reference is the same.

Tests this object against the comparison object. If any of the value type members are different, or if any of the properties are IMatchable and do not match, then this returns false.

The other IMatcheable object of the same type The list of property names that do not match Boolean, true if the properties are comparably equal.

IRandomizable

This method will set the values for this class with random values that are within acceptable parameters for this class.

An existing random number generator so that the random seed can be controlled

This copies the public descriptor properties from the specified object to this object.

An object that has properties that match the public properties on this object.

Creates a new instance of MatchableObject

For each of the publicly accessible properties found on this object, this attempts to copy a public property from the source object of the same name, if it can find it. For each matching property name/type, it will attempt to copy the value.

The

Compares the properties of this object with the specified IMatchable other. This does not test every property of other, but does test every property of this item. As long as the other item has corresponding properties for every property on this item, the items are said to match. The IMatchable interface allows custom definitions of matching. For collections to match, all of their sub-members must match.

The default behavior is to cycle through all the properties of this object, and call Randomize on any that implement the IRandomizable interface.

The Random seed generator for controling how the random content is created

This occurs while copying properties from the specified source, and is the default handling for subclasses

This gives sub-classes the chance to directly override, control or otherwise tamper with the matching process. This is also where normal matching is performed, so to replace it, simply don't call the base.OnMatch method. To tweak the results, the base method should be performed first, and the results can then be modified.

This allows overrideable behavior that can replace or extend the basic behavior, which is to call Randomize on any public properties that are listed as randomizeable. This does nothing to normal properties or non public members and needs to be overriden to provide the special case functionality for sub-classes.

The random number generator to be used during randomization

The LegendItem interface controls specifically the properties associated with the legend. It is assumed that All layers will support one legend item, but this way ostensibly we can eventually add things to the legend that are not technically layers.

Any item which can be contained by a parent item

The type class of the potential parent

Gets the parent item relative to this item.

Sets teh parent legend item for this item

Tests the specified legend item to determine whether or not it can be dropped into the current item.

Any object that implements ILegendItem Boolean that is true if a drag-drop of the specified item will be allowed.

Instructs this legend item to perform custom drawing for any symbols.

A Graphics surface to draw on The rectangular coordinates that confine the symbol.

Prints the formal legend content without any resize boxes or other notations.

The graphics object to print to The system.Drawing.Font to use for the lettering The color of the font Assuming 0, 0 is the top left, this is the maximum extent

Gets the size of the symbol to be drawn to the legend

This is a list of menu items that should appear for this layer. These are in addition to any that are supported by default. Handlers should be added to this list before it is retrieved.

Gets or sets whether or not this legend item should be visible. This will not be altered unless the LegendSymbolMode is set to CheckBox.

Gets or sets whether this legend item is expanded.

Gets or sets whether this legend item is currently selected (and therefore drawn differently)

Gets whatever the child collection is and returns it as an IEnumerable set of legend items in order to make it easier to cycle through those values.

Gets or sets a boolean, that if false will prevent this item, or any of its child items from appearing in the legend when the legend is drawn.

Gets the symbol mode for this legend item.

The text that will appear in the legend

Gets or sets a pre-defined behavior in the legend when referring to drag and drop functionality.

Creates a new instance of the legend item

Configures the default settings of the legend item

Returns a boolean indicating whether or not this item can have other items dropped on it. By default this is false. This can be overridden for more customized behaviors.

The item to test for dropping.

Draws the symbol for this specific category to the legend

Prints the formal legend content without any resize boxes or other notations.

The graphics object to print to The system.Drawing.Font to use for the lettering The color of the font Assuming 0, 0 is the top left, this is the maximum extent

Gets the nearest value.

The value. The values.

Bytes the range.

The value.

Handles updating event handlers during a copy process

Allows the ItemChanged event to fire in response to individual changes again. This will also fire the event once if there were any changes that warent it that were made while the event was suspended.

Each suspend call increments an integer, essentially keeping track of the depth of suspension. When the same number of ResumeChangeEvents methods have been called as SuspendChangeEvents have been called, the suspension is aborted and the legend item is allowed to broadcast its changes.

Gets or sets the size of the symbol to be drawn to the legend

Gets the Parent Legend item for this category. This should probably be the appropriate layer item.

Sets the parent legend item for this category.

Allows for the set behavior for the parent item to be overridden in child classes

Fires the ItemChanged event

Fires the ItemChanged event, optionally specifying a different sender

Instructs the parent legend item to remove this item from the list of legend items.

Occurs whenever the symbol content has been updated

Occurs whenever the item should be removed from the parent collection

Boolean, true if changes are suspended

Gets or sets a boolean that indicates whether or not this legend item can be dragged to a new position in the legend.

Gets or sets a boolean, that if false will prevent this item, or any of its child items from appearing in the legend when the legend is drawn.

Because these are in symbol mode, this is not used.

Gets the MenuItems that should appear in the context menu of the legend for this category

Gets or sets a boolean that indicates whether or not the legend should draw the child LegendItems for this category.

Gets or sets whether this legend item has been selected in the legend

Gets whatever the child collection is and returns it as an IEnumerable set of legend items in order to make it easier to cycle through those values. This defaults to null and must be overridden in specific cases where child legend items exist.

Gets or sets the symbol mode for the legend. By default this should be "Symbol", but this can be overridden

Gets or sets the text for this category to appear in the legend. This might be a category name, or a range of values.

Gets or sets a pre-defined behavior in the legend when referring to drag and drop functionality.

If this is true, then "can receive

Creates a new instance of Category

Creaates a new instance of this category, and tailors the range to the specifeid values.

The start value The end value

Creates a category that has the same value for both minimum and maximum

The value to use

Applies the snapping rule directly to the categories, instead of the breaks.

Searches the list and returns the nearest value in the list to the specified value.

Since rasters are numeric and not relying on an SQL expression, this allows this only sets the legend text using the method and digits to help with formatting.

An EditorSettings from either a feature scheme or color scheme.

Tests to see if the specified value falls in the range specified by this ColorCategory

The value of type int to test Boolean, true if the value was found in the range

Returns this Number as a string. This uses the DotSpatial.Globalization.CulturePreferences and Controls the number type using the NumberFormat enumeration plus the DecimalCount to create a number format.

The string created using the specified number format and precision.

Returns this Number as a string.

Specifies how the numbers are modified so that the numeric text can be cleaned up. An integer clarifying digits for rounding or significant figure situations. A string with the formatted number.

Maximum this is a convenient caching tool only, and doesn't control the filter expression at all. Use ApplyMinMax after setting this to update the filter expression.

Gets or sets the color to be used for this break. For BiValued breaks, this only sets one of the colors. If this is higher than the high value, both are set to this. If this equals the high value, IsBiValue will be false.

Gets the numeric Range for this color break.

Gets or sets a status message for this string.

This is not used by DotSpatial, but is provided for convenient linking for this object in plugins or other applications.

ChangeBase

Forces the Changed event to fire. If events are suspended, then this simply will mark the changes so that when the ResumeChanges is called it will automatically fire the Changed events.

Resumes the events. If any changes occured during the period of time when the events were suspended, this will automatically fire the chnaged event.

Causes this filter collection to suspend the Changed event, so that it will only be fired once after a series of updates.

Fires the Changed event as long as ChangesSuspended is not true.

Occurs when members are added to or removed from this collection. If SuspendChanges is called, this will temporarilly prevent this event from firing, until ResumeEvents has been called.

To suspend events, call SuspendChanges. Then to resume events, call ResumeEvents. If the suspension is greater than 0, then events are suspended.

ChangedObjectEvent

Creates a new instance of ChangedObjectEvent

Gets the item that has been changed

ColorEM

Creates a color with the same hue and saturation but that is slightly brighter than this color.

The starting color The floating point value of brightness to add to this color. If the combined result is greater than 1, the result will equal one. A color lighter than this color

Creates a color with the same hue and saturation but that is slightly darker than this color.

The starting color The floating point value of brightness to add to this color. if the combined result is less than 0, the result will equal 0. A color darker than this color.

Calculates the opacity as a function of the Alpha channel.

The color to determine the opacity for

Given a floating point opacity, where 0 is fully transparent and 1 is fully opaque, this will generate a new color that is the transparent version.

Returns an equivalent version of this color that is fully opaque (having an alpha value of 255)

The transparent color The new Color

uses a linear ramp to extrapolate the midpoint between the specified color and the new color as defined by ARGB values independantly

This color The color to blend with this color A color that is midway between this color and the specified color

RasterColorSchemes

DeadSea

Desert

Fall Leaves

Glacier

Highway

Meadow

Summer Mountains

Valley Fires

ILabel

Occurs when the Symbolizer for this label is changed.

Gets or sets the geographic position for the anchoring the label. The relationship between this and the text depends on the horizontal alignment.

Gets the integer index for this label

Gets the Symbol group that currently contains this label.

Gets or sets the text that appears on this layer.

Gets or sets the symbolizer for this specific label. This allows customization for individual labels, but at the same time can allow many labels to point to one set of symbolic characteristics.

Gets or sets the symbolizer that is being used. Symbol groups are defined by the original symbolizer, and there is only one selection symbolizer per group. This simply is a shortcut to accessing the symbolgroup's selection symbolizer.

This interface provides ability to use in RasterLayer any custom actions (including GUI-dependent dialogs)

SHow properties dialog

Raster layer

Show export dialog

Raster

ITextSymbolGroup

Add a new integer into this group.

The label to be added to the group. Boolean, false if the integer was already in this group.

Removes all the selected indices and returns them to the regular indices. This returns a list of integer indices for the labels that were changed.

Selects a single label

The integer label to select

Unselect a single label in this group.

The integer label

Gets or sets the text symbolizer for this group of labels

Gets or sets the list of regular labels based on their index in the actual list of labels

Gets or sets the list of selected labels based on their index in the actual list of labels

Gets or sets the set of symbolic characteristics that should be used for drawing selected labels.

A generic event argument that also allows sending the strong typed item.

The generic item associated with the event.

Creates a new instance of hte LegendItemEventArgs

The item associated with the event. This is not necessarilly the sender.

The item associated with this event. This is not necessarilly the sender.

An EventArgs specifically tailored to LabelLayerEventArgs.

Initializes a new instance of the LabelLayerEventArgs class.

The ILabelLayer that is involved in this event.

Gets the LabelLayer associated with this event.

PointFConverter

True if the source type is a string

Boolean, true if source type is a string

Uses a string to return a new Position2D

A String

Creates a string from the specified Position2D

A Position2D

An EventArgs specifically tailored to RasterLayer.

Initializes a new instance of the RasterLayerEventArgs class.

The IRasterLayer that is involved in this event.

Gets the RasterLayer associated with this event.

The ExpandableSetConverter works by assuming that a pair of

Returns true if the source type is string

Converts a string into a Size2D

Converts the Size2D into a string

A new model, now that we support 3.5 framework and extension methods that are essentially derived characteristics away from the IRaster interface, essentially reducing it to the simplest interface possible for future implementers, while extending the most easy-to-find functionality to the users.

Create Hillshade of values ranging from 0 to 1, or -1 for no-data regions. This uses the progress handler defined on this raster.

The raster to create hillshade information for An implementation of IShadedRelief describing how the hillshade should be created.

Create Hillshade of values ranging from 0 to 1, or -1 for no-data regions. This should be a little faster since we are accessing the Data field directly instead of working through a value parameter.

The raster to create the hillshade from. An implementation of IShadedRelief describing how the hillshade should be created. An implementation of IProgressHandler for progress messages

Create Hillshade of values ranging from 0 to 1, or -1 for no-data regions. This should be a little faster since we are accessing the Data field directly instead of working through a value parameter.

The raster to create the hillshade from. An implementation of IShadedRelief describing how the hillshade should be created. An implementation of IProgressHandler for progress messages

Creates a bitmap from this raster using the specified rasterSymbolizer

The raster to draw to the bitmap based on the layout specified in the rasterSymbolizer The raster symbolizer to use for assigning colors This must be an Format32bbpArgb bitmap that has already been saved to a file so that it exists. rasterSymbolizer cannot be null

Creates a bitmap from this raster using the specified rasterSymbolizer

The raster to draw to a bitmap The raster symbolizer to use for assigning colors This must be an Format32bbpArgb bitmap that has already been saved to a file so that it exists. The progress handler to use. rasterSymbolizer cannot be null

Creates a bitmap from this raster using the specified rasterSymbolizer

The raster to draw to a bitmap The raster symbolizer to use for assigning colors Byte values representing the ARGB image bytes The stride The progress meter to use. rasterSymbolizer cannot be null

Creates a bitmap from this raster using the specified rasterSymbolizer

The raster to draw to a bitmap The raster symbolizer to use for assigning colors Byte values representing the ARGB image bytes The stride The progress meter to use. rasterSymbolizer cannot be null

Returns an integer that ranges from 0 to 255. If value is larger than 255, the value will be equal to 255. If the value is smaller than 255, it will be equal to 255.

A Double value to convert. An integer ranging from 0 to 255

Creates a bitmap from this raster using the specified rasterSymbolizer

The raster to draw to a bitmap The raster symbolizer to use for assigning colors Byte values representing the ARGB image bytes The stride The progress meter to use. rasterSymbolizer cannot be null

Creates a bitmap using only the colorscheme, even if a hillshade was specified.

The Raster containing values that need to be drawn to the bitmap as a color scheme. The raster symbolizer to use. The bitmap to edit. Ensure that this has been created and saved at least once. An IProgressHandler implementation to receive progress updates. rasterSymbolizer cannot be null.

Creates a bitmap using only the colorscheme, even if a hillshade was specified.

Obtains a list of unique values from the grid.

The IRaster to obtain unique values for A list of double values, where no value is repeated.

Obtains a list of unique values. If there are more than maxCount values, the process stops and overMaxCount is set to true.

the raster to obtain the unique values from. An integer specifying the maximum number of values to add to the list of unique values A boolean that will be true if the process was halted prematurely. A list of doubles representing the independant values.

This will sample randomly from the raster, preventing duplicates. If the sampleSize is larger than this raster, this returns all of the values from the raster. If a "Sample" has been prefetched and stored in the Sample array, then this will return that.

DrawArgs contains the parameters necessary for 2D drawing

Creates a new instance of DrawArgs

A System.Windows.Drawing.Graphics object A DotSpatial.Drawing.DrawWindow to draw to

Creates a new instance of DrawArgs

A System.Windows.Drawing.Graphics object A DotSpatial.Drawing.DrawWindow to draw to An integer part representing a value from 0 to NumParts being drawn

Creates a new instance of DrawArgs

A System.Windows.Drawing.Graphics object A DotSpatial.Drawing.DrawWindow to draw to An integer part representing a value from 0 to NumParts being drawn The integer stage representing an object that has several stages, for all of the parts to be passed through

Gets the Graphics device to draw to

Gets the geographic extent for the drawing operation

Gets the part index being drawn.

Gets the integer stage index. As an example, if all the borders are drawn first, and then all the fillings are drawn, but each stage has several parts, the stage gives a way to subdivide a larger object into several drawing passes.

A set of PaintEventArgs that can be used before a drawing function in order to cancel an event.

Creates a new instance of the DrawCompleted Event Arguments

A Graphics surface An implementation of DotSpatial.Geometries.IEnvelope defining the geographic drawing region True if the draw method was cancelled before any rendering took place. A Cancel is different from when an acception is thrown. If an exception occured during rendering, this will not be null.

Creates a default DrawCompleted event for the situation where the drawing was successful, not cancelled and no exception occured

The DrawArgs being used during the drawing, specifying the Graphics device and geographic envelope A boolean parameter specifying whether or not the drawing was cancelled

Creates a new DrawCompleted in the case where an exception was thrown

The drawing arguments for drawing, specifying the Graphics device and the geographic envelope The Exception being thrown

Boolean, true if the draw method was cancelled before rendering took place. This will not be true if visible was false or an exception was thrown.

An Exception object for situations where the drawing threw an exception.

A set of PaintEventArgs that can be used before a drawing function in order to cancel an event.

Creates a new instance of the CancelPaint Event Arguments.

The device that contains the drawing information for the event to determine whether or not to cancel. The geographic bounds of the draw event The part being drawn. This is usually 0, unless NumParts is greater than 1. The 0-based integer index indicating the stage of the drawing. A boolean specifying the default setting for the draw args.

Constructs a new instance with cancel set to false using an Existing DrawArgs

Returns a boolean specifying whether the action that caused the default drawing for this event should be prevented.

A Draw Window is a special type of envelope that supports some basic transformations

Creates a new instance of DrawWindow, making the assumption that the map is in Geographic coordinates of decimal degrees

Creates a new draw window with the specified coordinates

The first x-value. The second x-value. The first y-value. The second y-value. The first z-value. The second z-value.

Constructs a new DrawWindow based on the specified IEnvelope. The envelope becomes the GeographicView for this DrawWindow.

Replaces the inherited Envelope copy in order to create a copy of the DrawWindow instead

Replaces the inherited clone in order to make a copy of the DrawWindow

Converts two dimensions of the specified coordinate into a two dimensional PointF

A PointF

Converts two dimensions of the specified coordinate into a two dimensional PointF

Any valid ICoordinate A PointF

Converts two dimensions of the specified coordinate into a two dimensional PointF.

Converts a PointF from the draw window back into the double precision data coordinate.

Converts an Array of PointF values from the draw window back into the double precision data coordinates. There will be uncertainty based on how zoomed in you are.

Calculates a geographic envelope from the specified window in the DrawWindow coordinates.

This calculates the DrawWindowView from the GeographicView

This is the the current extent of the map in geographic coordinates.

Retrieves the MinX value of the GeographicView, in DrawWindow coordinates

The main difference here is that tests against the DrawWindow happen before the nested Draw2D methods. The DrawWindow is editable at this stage, but will become read-only during drawing.

Creates a new instance of DrawArgs

A System.Windows.Drawing.Graphics object A DotSpatial.Drawing.DrawWindow to draw to

Gets the Graphics device to draw to

Gets or sets the geographic extent for the drawing operation

DynamicVisibilityModes

The layer will only be visible when zoomed in closer than the DynamicVisibilityWidth.

The layer will only be visible when zoomed out beyond the DynamicVisibilityWidth.

EditorSettings

Creates a new instance of EditorSettings

Gets or sets the characteristics of the "right" color.

Gets or sets a string that allows the user to use any of the data fields to eliminate values from being considered as part of the histogram for statistical interval calculations.

Gets or sets a boolean indicating to display the hue, saturation, lightness as bounds instead of start-color, end-color.

Gets or sets the hue shift.

Gets or sets the interval method

Gets or sets the maximum sample count.

Gets or sets the integer count if equal breaks are used

Gets or sets whether this editor should ramp the colors, or use randomly generated colors. The default is random.

Gets or sets the characteristics of the "left" color.

Gets or sets whether to use the color specifications

Gets or sets how intervals like equal breaks choose the actual values, and whether they are rounded or snapped.

Gets or sets the number of digits to preserve when IntervalSnapMethod is set to Rounding

World or pixel coordinates

No referencing was specified so the default will be used

The coordinates are given relative to the geographic locations, rather than pixel coordinates

The coordinates are given in pixels

An enumeration showing whetehr this item should use a picture or an image

No specification was set, so use the default

Specifies to use an icon

Specifies to use an image

Gives an enumeration for several different line styles

Specifies that none of the normal options were chosen so a default should be used.

This will draw the specified line so that the curve joins itself at the ends.

Draws a cardinal spline through the points of this feature

Draws a set of line segments through the points of this feature

This is like a boolean, but with a "default" of empty. Empty signifies that the value is not specified.

Not specified

Specified as true

Specified as false

Specifies the OGC type of connection that can occur between two segments

Flat?

Rounded

Beveled

Specifies the OGC treatment to give the line at the end-points

Flat?

Round

flat but a little outwards

EnvelopeArgs

Creates a new instance of EnvelopeArgs

Gets the envelope specific to this event.

SelectionEventArgs

Creates a new instance of SelectionEventArgs

Gets the list of features that were changed by this event.

FeatureChangeEnvelopeArgs

Creates a new instance of FeatureChangeEnvelopeArgs

Gets the geographic envelope for the most recent selection event.

FieldInfo

Determines whether there is a member with the specified name

FilterCollectionEM

Adds all the features in the specified range. This will throw an exception if the the features are not already in the feature list, since this is simply trying to select those features.

The IFilterCollection to add the range to The features being selected.

This uses extent checking (rather than full polygon intersection checking). It will add any members that are either contained by or intersect with the specified region depending on the SelectionMode property. The order of operation is the region acting on the feature, so Contains, for instance, would work with points.

True if any item was actually added to the collection

Removes the entire list of features

The IFilterCollection to remove the range from The enumerable collection of IFeatures.

Tests each member currently in the selected features based on the SelectionMode. If it passes, it will remove the feature from the selection.

The IFilterCollection that this should be applied to The geographic region to remove Boolean, true if the collection was changed

An enumeration specifying the way that a gradient of color is attributed to the values in the specified range.

The values are colored in even steps in each of the Red, Green and Blue bands.

The even steps between values are used as powers of two, greatly increasing the impact of higher values.

The log of the values is used, reducing the relative impact of the higher values in the range.

GraphicsPathEM

Adds a round rectangle to the graphics path where the integer radius specified determines how rounded the rectangle should become. This can be thought of rounded arcs connected by straight lines.

Adds the unclosed set of lines that are the top and left of the shape

Adds the unclosed set of lines that are the bottom and right of the shape

Tests each of the points in the graphics path, and calculates a RectangleF that completely contains all of the points in the graphics path.

The grpahics path to test. A RectangleF

Group

Layer

RenderableLegendItem

Items with this setup can both be organized as an item, and feature the elemental control methods and properties around drawing. Layers, MapFrames, groups etc can fall in this category.

Anything that can draw itself to the map is an IRenderable. This is implemented by RenderBase.

Invalidates the drawing methods

Occurs whenever the geographic bounds for this renderable object have changed

Occurs when an outside request is sent to invalidate this object

Occurs immediately after the visible parameter has been adjusted.

Obtains an IEnvelope in world coordinates that contains this object

Gets whether or not the unmanaged drawing structures have been created for this item

If this is false, then the drawing function will not render anything. Warning! This will also prevent any execution of calculations that take place as part of the drawing methods and will also abort the drawing methods of any sub-members to this IRenderable.

Creates a new instance of RenderBase

Invalidates the drawing methods

Fires the EnvelopeChanged event.

The object sender for this event (this) The EnvelopeArgs specifying the envelope

Fires the Invalidated event

The object sender (usually this) An EventArgs parameter

Fires the Visible Changed event

The object sender (usually this) An EventArgs parameter

Occurs whenever the geographic bounds for this renderable object have changed

Occurs when an outside request is sent to invalidate this object

Occurs immediately after the visible parameter has been adjusted.

The protected extent is a direct, sealed accessor for the extent variable. This is safe to use in constructors.

Obtains an IEnvelope in world coordinates that contains this object. This is virtual, and will usually be reconfigured in subclasses to simply show the dataset extent.

Gets whether or not the unmanaged drawing structures have been created for this item

Just specifies the organization of interfaces that make up a layer. It is recommended to create derived classes that inherit from an abstract layer that implements the majority of this shared functionality

This supports the FeatureLayer event SelectionChanged, for both groups and feature layers, or any other layer that supports both an ISelection and inherits from IFeatureLayer.

Removes any members from existing in the selected state

Inverts the selected state of any members in the specified region.

The geographic region to invert the selected state of members The geographic region when working with absolutes, without a tolerance The selection mode determining how to test for intersection The geographic region encapsulating the changed members Boolean, true if members were changed by the selection process.

Adds any members found in the specified region to the selected state as long as SelectionEnabled is set to true.

The geographic region where selection occurs The geographic region when working with absolutes, without a tolerance The selection mode The envelope affected area Boolean, true if any members were added to the selection

Removes any members found in the specified region from the selection

The geographic region to investigate The geographic region when working with absolutes, without a tolerance The selection mode to use for selecting items The geographic region containing all the shapes that were altered Boolean, true if any members were removed from the selection

OCcurs after all of the layers have been updated with new selection content.

Gets or sets the Boolean indicating whether this item is actively supporting selection

Given a geographic extent, this tests the "IsVisible", "UseDynamicVisibility", "DynamicVisibilityMode" and "DynamicVisibilityWidth" In order to determine if this layer is visible.

The geographic extent, where the width will be tested. Boolean, true if this layer should be visible for this extent.

Notifies the layer that the next time an area that intersects with this region is specified, it must first re-draw content to the image buffer.

The envelope where content has become invalidated.

Queries this layer and the entire parental tree up to the map frame to determine if this layer is within the selected layers.

Occurs before the properties are actually shown, also allowing the event to be handled.

Occurs if the maps should zoom to this layer.

Occurs if this layer was selected

Occurs when all aspects of the layer finish loading.

Gets or sets the core dataset for this layer.

Gets the currently invalidated region.

Gets the MapFrame that contains this layer.

Gets or sets the progress handler

Creates a new Layer, but this should be done from the derived classes

The container this layer should be a member of

Creates a new layer with only a progress handler

Creates a new Layer, but this should be done from the derived classes

The container this layer should be a member of A progress handler for handling progress messages

Given a geographic extent, this tests the "IsVisible", "UseDynamicVisibility", "DynamicVisibilityMode" and "DynamicVisibilityWidth" In order to determine if this layer is visible for the specified scale.

The geographic extent, where the width will be tested. Boolean, true if this layer should be visible for this extent.

Tests the specified legend item. If the item is another layer or a group or a map-frame, then this will return false. Furthermore, if the parent of the item is not also this object, then it will also return false. The idea is that layers can have sub-nodes move around, but not transport from place to place.

the legend item to test Boolean that if true means that it is ok to insert the specified item into this layer.

Queries this layer and the entire parental tree up to the map frame to determine if this layer is within the selected layers.

Notifies the layer that the next time an area that intersects with this region is specified, it must first re-draw content to the image buffer.

The envelope where content has become invalidated.

Notifies parent layer that this item is invalid and should be redrawn.

Fires the zoom to layer event

Fires the zoom to layer event, but specifies the extent.

IEnvelope env

Occurs before showing the properties dialog. If the handled member was set to true, then this class will not show the event args.

This should be overridden to copy the symbolizer properties from editCopy

The version that went into the property dialog

Zooms to the specific layer

Removes this layer from its parent list

Fires the LayerSelected event

Fires the OnFinishedLoading event.

Occurs when instructions are being sent for this layer to export data.

special treatment for event handlers during a copy event

Opens a fileName using the default layer provider and returns a new layer. The layer will not automatically have a container or be added to a map.

The string fileName of the layer to open An ILayer interface

Opens a fileName using the default layer provider and returns a new layer. The layer will not automatically have a container or be added to a map.

The string fileName of the layer to open An IProgresshandler that overrides the Default Layer Manager's progress handler An ILayer interface with the new layer.

Opens a new layer and automatically adds it to the specified container.

A String fileName to attempt to open. The container (usually a LayerCollection) to add to The layer after it has been created and added to the container

Attempts to call the open fileName method for any ILayerProvider plugin that matches the extension on the string.

A String fileName to attempt to open. A boolean value that if true will attempt to force a load of the data into memory. This value overrides the property on this LayerManager. A container to open this layer in Specifies the progressHandler to receive progress messages. This value overrides the property on this LayerManager. An ILayer

This is overriden in sub-classes

The geographic envelope in cases like cliking near points where tolerance is allowed The geographic region when working with absolutes, without a tolerance

This is overriden in sub-classes

The geographic envelope in cases like cliking near points where tolerance is allowed The geographic region when working with absolutes, without a tolerance

This is overriden in sub-classes

The geographic envelope in cases like cliking near points where tolerance is allowed The geographic region when working with absolutes, without a tolerance

Disposes the memory objects in this layer.

Locks dispose. This typically adds one instance of an internal reference counter.

Unlocks dispose. This typically removes one instance of an internal reference counter.

Reprojects the dataset for this layer.

The target projection to use.

Fires the SelectionChanged event

Finalizes an instance of the Layer class.

This allows overriding layers to handle any memory cleanup.

True if managed resources should be set to null.

Occurs if this layer was selected

Occurs if the maps should zoom to this layer.

Occurs before the properties are actually shown, also allowing the event to be handled.

Occurs when all aspects of the layer finish loading.

Occurs after the selection is changed

Gets or sets custom actions for Layer

Gets or sets the internal data set. This can be null, as in the cases of groups or map-frames. Copying a layer should not create a duplicate of the dataset, but rather it should point to the original dataset. The ShallowCopy attribute is used so even though the DataSet itself may be cloneable, cloning a layer will treat the dataset like a shallow copy.

Dynamic visibility represents layers that only appear when you zoom in close enough. This value represents the geographic width where that happens.

This controls whether the layer is visible when zoomed in closer than the dynamic visibility width or only when further away from the dynamic visibility width

Gets the currently invalidated region.

Gets the map frame of the parent LayerCollection.

Gets or sets the ProgressHandler for this layer. Setting this overrides the default behavior which is to use the

Gets or sets a boolean indicating whether to allow the dynamic visibility envelope to control visibility.

Layers launch a "Property Grid" by default. However, this can be overridden with a different UIEditor by this

Gets or sets the progress meter being used internally by layer classes.

Gets or sets a boolean indicating whether the memory objects have already been disposed of.

Gets or sets the boolean that controls whether or not items from the layer can be selected

Gets a value indicating whether an existing reference is requesting that the object is not disposed of. Automatic disposal, as is the case when a layer is removed from the map, will not take place until all the locks on dispose have been removed.

Gets a Boolean indicating if this layer can be reprojected.

Gets the or sets the projection information for the dataset of this layer. This only defines the projection information and does not reproject the dataset or the layer.

Gets or sets the unmodified projection string that can be used regardless of whether the DotSpatial.Projection module is available. This string can be in the Proj4string or in the EsriString format. Setting the Projection string only defines projection information. Call the Reproject() method to actually reproject the dataset and layer.

Group

Resume events will resume events on the layers if all the suspensions are canceled out.

Adds one more increment of suspension which will prevent events from firing for the layers.

Gets the layers cast as ILayer without any information about the actual drawing methods. This is useful for handling methods that my come from various types of maps.

An enumerable collection of ILayer

Returns the number of data layers, not counting groups. If recursive is true, then layers that are within groups will be counted, even though the groups themselves are not.

Boolean, if true forces checking even the number of child members. An integer representing the total number of layers in this collection and its children.

Returns a snapshot image of this group

Width in pixels of the returned image (height is determined by the number of layers in the group) Bitmap of the group and sublayers (expanded)

Gets the layer handle of the specified layer

0 based index into list of layers Layer's handle on success, -1 on failure

This occurs when a new layer is added either to this group, or one of the child groups within this group.

This occurs when a layer is removed from this group.

Gets whether or not the events are suspended on the layer collection

Gets the integer handle for this group

Gets or sets the icon

Gets the integer count of layers. This can also be accessed through Layers.Count.

Gets or sets the visibility of the layers within this group. Note: When reading this property, it returns true if any layer is visible within this group

Gets the parent group of this group.

gets or sets the locked property, which prevents the user from changing the visual state except layer by layer

Creates a new instance of Group

Creates a group that sits in a layer list and uses the specified progress handler

the progress handler

Creates a group that sits in a layer list and uses the specified progress handler

the layer list the progress handler

Gets the layer handle of the specified layer

0 based index into list of layers Layer's handle on success, -1 on failure

Creates a virtual method when sub-groups are being created

Given a new LayerCollection, we need to be sensitive to certain events

Occurs when removing a layer. This also fires the LayerRemoved event.

Simply echo this event out to members above this group that might be listening to it.

When setting an old layer collection it is advisable to not only add new handlers to the new collection, but remove the handlers related to the old collection.

Disposes the unmanaged resourced of this group. If disposeManagedResources is true, then this will also dispose the resources of the child layers and groups unless they are dispose locked.

Boolean, true to dispose child objects and set managed members to null.

This occurs when a new layer is added either to this group, or one of the child groups within this group.

This occurs when a layer is removed from this group.

gets or sets the list of layers.

Boolean, true if any sub-layers in the group are visible. Setting this will force all the layers in this group to become visible.

The envelope that contains all of the layers for this data frame. Essentially this would be the extents to use if you want to zoom to the world view.

Gets the integer handle for this group

Gets or sets the icon

Gets the currently invalidated region as a union of all the invalidated regions of individual layers in this group.

Returns the count of the layers that are currently stored in this map frame.

Gets a boolean that is true if any of the immediate layers or groups contained within this control are visible. Setting this will set the visibility for each of the members of this map frame.

This is a different view of the layers cast as legend items. This allows easier cycling in recursive legend code.

Gets the parent group of this group.

Gets or sets the progress handler to use. Setting this will set the progress handler for each of the layers in this map frame.

gets or sets the locked property, which prevents the user from changing the visual state except layer by layer

ICategory

Applies the minimum and maximum in order to create the filter expression. This will also count the members that match the specified criteria.

Applies the snapping rule directly to the categories, instead of the breaks.

For quantitative categories, this simply tests to see if the specified value can be found between the minimum and maximum range values.

The double value to check against the minimum and maximum values. Boolean, true if the value is inside the range.

Returns this Number as a string.

Specifies how the numbers are modified so that the numeric text can be cleaned up. An integer clarifying digits for rounding or significant figure situations. A string with the formatted number.

Minimum this is a convenient caching tool only, and doesn't control the filter expression at all. Use ApplyMinMax after setting this to update the filter expression.

Maximum this is a convenient caching tool only, and doesn't control the filter expression at all. Use ApplyMinMax after setting this to update the filter expression.

Gets or sets the value range, which overrides any existing min/max setup. This is only valid for numeric values that can be expressed as doubles.

Gets or sets a status message for this string.

This is not used by DotSpatial, but is provided for convenient linking for this object in plugins or other applications.

IChangeable

Resumes the events. If any changes occured during the period of time when the events were suspended, this will automatically fire the chnaged event.

Causes this filter collection to suspend the Changed event, so that it will only be fired once after a series of updates.

Occurs when members are added to or removed from this collection. If SuspendChanges is called, this will temporarilly prevent this event from firing, until ResumeEvents has been called.

To suspend events, call SuspendChanges. Then to resume events, call ResumeEvents. If the suspension is greater than 0, then events are suspended.

This interface stores a single extent window describing a view, and also contains the list of all the layers associated with that view. The layers are ordered.

This will create a new layer from the featureset and add it.

Any valid IFeatureSet that does not yet have drawing characteristics

Occurs when some items should no longer render, and the map needs a refresh.

Occurs after zooming to a specific location on the map and causes a camera recent.

Gets or sets a boolean that controls whether or not a newly added layer will also force a zoom to that layer. If this is true, then nothing will happen. Otherwise, adding layers to this frame or a group in this frame will set the extent.

Drawing layers are tracked separately, and do not appear in the legend.

Gets or sets the currently active layer.

Controls the smoothing mode. Default or None will have faster performance at the cost of quality.

This is the geographic envelope in view.

A layer or other object capable of containing

Draws every label in the layer without worrying about any collision testing or specific tests outside of this label container. If LabelCollisionTesting is set to true, it should still do collision testing for the labels INSIDE this label container.

The list of integers corresponds to the integer values that were returned as keys to the GetLabelExtents dictionary. The Layer will then draw each of the specific lables to draw.

Gets the list of non-rotated extents for labels visible in the current display. The integer keys represent the index of the labeled item. The envelope values represent the actual rectangles that the labels occupy for collision testing. If LabelCollisionTesting is true, then collisions should be resolved for the entire layer first based on whatever internal priority methods exist. Only the non-colliding visible labels will be returned.

Gets the list of possibly rotated label boundaries visible in the current display. The integer keys represent the index of the labeled item. The envelope values represent the actual rectangles that the labels occupy for collision testing. If LabelCollisionTesting is true, then collisions should be resolved for the entire layer first based on whatever internal priority methods exist. Only the non-colliding visible labels will be returned.

The integer indexed list of all the labels in this container.

If this is set to true, then the only labels being sent to GetLabelExtents should be the labels that actually need to be drawn.

A priority rating for all the labels in this layer. The higher this number, the more likely the labels from this layer are to win a collision contest between layers.

ILayerCollection2

Constructor

ILayerEvents

Selects the layer to use for tools or operations that act on a single layer.

The integer index indicating the layer to select in this collection.

Occurs when a layer is added to this item.

Occurs when a layer is removed from this item.

Occurs when one of the layers in this collection changes visibility.

Zooms to a layer

Occurs immediately after the layer is selected.

Occurs when the selection on a feature layer changes.

Occurs after the selection has been updated for all the layers.

Given a base name, this increments a number for appending if the name already exists in the collection.

The string base name to start with The base name modified by a number making it unique in the collection

Gets or sets the ParentGroup for this layer collection, even if that parent group is not actually a map frame.

Gets or sets the MapFrame for this layer collection.

Gets or sets the currently active layer.

IDataManager

This launches an open file dialog and attempts to load the specified file.

The layer will be created in the specified collection A Layer

This launches an open file dialog and attempts to load the specified file.

Specifies the progressHandler to receive progress messages. This value overrides the property on this DataManager. A Layer

Opens a new layer and automatically adds it to the specified container.

A String fileName to attempt to open. The container (usually a LayerCollection) to add to The layer after it has been created and added to the container

This launches an open file dialog and attempts to load the specified file.

A String fileName to attempt to open. Specifies the progressHandler to receive progress messages. This value overrides the property on this DataManager. A Layer

Attempts to call the open fileName method for any IDataProvider plugin that matches the extension on the string.

A String fileName to attempt to open.

Attempts to call the open fileName method for any IDataProvider plugin that matches the extension on the string.

A String fileName to attempt to open. A boolean value that if true will attempt to force a load of the data into memory. This value overrides the property on this DataManager. any valid IContainer that this should be added to Specifies the progressHandler to receive progress messages. This value overrides the property on this DataManager.

This opens a file, but populates the dialog filter with only raster formats.

An IRaster with the data from the file specified in an open file dialog

This opens a file, but populates the dialog filter with only raster formats.

An IFeatureSet with the data from the file specified in a dialog

This attempts to open the specified raster file and returns an associated layer

The string fileName to open An IRaster with the data from the file specified in an open file dialog

This attempts to open the specified vector file and returns an associated layer

the string fileName to open An IFeatureSet with the data from the file specified in a dialog

This create new method implies that this provider has the priority for creating a new file. An instance of the dataset should be created and then returned. By this time, the fileName will already be checked to see if it exists, and deleted if the user wants to overwrite it.

The string fileName for the new instance The string short name of the driver for creating the raster The number of columns in the raster The number of rows in the raster The number of bands to create in the raster The data type to use for the raster The options to be used. An IRaster

Checks a dialog filter and returns a list of just the extensions.

The Dialog Filter to read extensions from A list of extensions

Given a string fileName for the "*.dll" file, this will attempt to load any classes that implement the IDataProvder interface.

The string path of the assembly to load from. A list that contains only the providers that were just loaded. This may be a list of count 0, but shouldn't return null.

This should be called once all the permitted directories have been set in the code. This will not affect the PreferredProviders or the general list of Providers. These automatically have the lowest priority and will only be used if nothing else works. Use the PreferredProviders to force preferential loading of a plugin DataProvider.

A list of just the newly added DataProviders from this method.

Occurs after the directory providers have been loaded into the project.

Gets or sets a temporary list of active project layers. This is designed to house the layers from a map frame when the property grids are shown for layers in that map frame. This list on the DefaultLayerManager is what is used to create the list that populates dropdowns that can take a Layer as a parameter.

Gets or sets the list of IDataProviders that should be used in the project.

Gets or sets the path (either as a full path or as a path relative to the DotSpatial.dll) to search for plugins that implement the IDataProvider interface.

Gets or sets the dialog read filter to use for opening data files.

Gets or sets the dialog write filter to use for saving data files.

Sets the default condition for how this data manager should try to load layers. This will be overridden if the inRam property is specified as a parameter.

Gets or sets the dialog read filter to use for opening data files that are specifically raster formats.

Gets or sets the dialog write filter to use for saving raster files.

Gets or sets the dialog read filter to use for opening vector files.

Gets or sets the dialog write filter to use for saving vector files.

Gets or sets a dictionary of IDataProviders keyed by the extension. The standard order is to try to load the data using a PreferredProvider. If that fails, then it will check the list of dataProviders, and finally, if that fails, it will check the plugin Data Providers in directories.

Gets or sets a progress handler for any open operations that are intiated by this DataManager.

geoGraphics

Creates a new instance of the ImageGraphics class for assisting with drawing.

The destination rectangle on the bitmap where drawing should occur.

The geographic extents where drawing will take place.

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

IImageLayer

Gets or sets a class that has some basic parameters that control how the image layer is drawn.

Gets or sets the dataset specifically as an IImageData object

Gets or sets the image being drawn by this layer

IImageSymbolizer

GeoImageLayer

Creates a blank image layer that needs to be configured later.

Creates a new instance of the ImageLayer by opening the specified fileName

Creates a new instance of the ImageLayer by opening the specified fileName, relaying progress to the specified handler, and automatically adds the new layer to the specified container.

The fileName to open A ProgressHandler that can receive progress updates The layer list that should contain this image layer

Creates a new instance of the image layer by opening the specified fileName and relaying progress to the specified handler.

The fileName to open The progressHandler

Creates a new instance of GeoImageLayer

Creates a new instance of a GeoImageLayer

The image to draw as a layer The Layers collection that keeps track of the image layer

Handles when this layer should show its properties by firing the event on the shared event sender

Handles export data from this layer.

Dispose memory objects.

True if managed memory objects should be set to null.

Gets or sets the underlying data for this object

Gets the geographic bounding envelope for the image

Gets or sets a class that has some basic parameters that control how the image layer is drawn.

Gets or sets the image being drawn by this layer

Gets or sets custom actions for ImageLayer

ImageSymbolizer

ITiledImageLayer

Gets or sets the TiledImage that supports the tile data for this image.

TiledImageLayer

Creates a new instance of TiledImageLayer

The bounding envelope of the image layer

The tiled image dataset

IPropertyDialogProvider

Shows a PropertyGrid Dialog and uses the specified object as the edit copy.

A clone of the actual object to be edited. This should not be the original object.

Fires an event signifying that the item has been updated

Gets the item that was changed by this operation.

IScheme

Adds a new scheme, assuming that the new scheme is the correct type.

The category to add

Applies the snapping rule directly to the categories, based on the most recently collected set of values, and the current VectorEditorSettings.

Creates the category using a random fill color

The base color to use for creating the category For points this is the maximal point size, for lines this is the maximum line width A new IFeatureCategory that matches the type of this scheme

Uses the settings on this scheme to create a random category.

A new ICategory

Reduces the index value of the specified category by 1 by exchaning it with the category before it. If there is no category before it, then this does nothing.

/// The category to decrease the index of

Draws the regular symbolizer for the specified cateogry to the specified graphics surface in the specified bounding rectangle.

The integer index of the feature to draw. The Graphics object to draw to The rectangular bounds to draw in

Re-orders the specified member by attempting to exchange it with the next higher index category. If there is no higher index, this does nothing.

The category to increase the index of

Inserts the category at the specified index

The integer index where the category should be inserted The category to insert

Removes the specified category

The category to insert

Suspends the category events

Resumes the category events

Clears the categories

Gets or sets the editor settings that control how this scheme operates.

This is cached until a GetValues call is made, at which time the statistics will be re-calculated from the values.

Gets the current list of values calculated in the case of numeric breaks. This includes only members that are not excluded by the exclude expression, and have a valid numeric value.

Characterizes

Boolean Tests a value against the minimum and maximum values. If the value is greater than or equal to the MinValue and is less than or equal to the MaxValue then it will be included.

The IComparable value to test. This is usually a numeric value. True if value is between MinValue and MaxValue

The classification must implement IComparable. The normal value types like strings, doubles and integers already do this. If the CompareTo method on value returns 0 when compared to the Classification property of this instance, this method will return true. Otherwise, it returns false.

Any valid implementation of IComparable. This can be either the default value types like integer or string, or else it can be a custom implementation of IComparable. Boolean, true if value.CompareTo returns 0 when compared against this classification.

The minimum value, inclusive, in a range of values. If the value being tested is less than this value, then these properties should not be applied.

Describes the maximum value, inclusive, in a range of values. If the value being tested is greater than this value, then these properties should not be applied.

The classification for this symbol. This is the same as specifying the MinValue and MaxValue to be equal and testing the IsInRange property.

A smaller interface that just gives the user enough control to draw on a map surface without giving them the ability to change the base control.

Causes the view to shift in geographic coordinates by the specified dX and dY. The geographic width and height of the Extents will remain the same, as will the aspect ratio.

Double specifying the pixel change in X position Double specifying the pixel change in Y position

Expands or shrinks the envelope so that it's new size is the specified percent of the previous size. The aspect ratio will be preserved.

The double percentage of the previous size Zoom in to a geographic extents half as large: Zoom(50); Zoom out to a geographic extents twice as large: Zoom(200);

Transforms a valid location on the screen (relative to the upper left corner of the map) into world coordinates (like longitude, latitude)

The integer pixel location relative to the left of the control The integer pixel location relative to the top of the control The double horizontal or longitude coordinate The double vertical or latitude coordinate

Transforms a valid location on the screen (relative to the upper left corner of the map) into world coordinates (like longitude, latitude)

A Point showing the PixelPosition A Valid ICoordiante showing the location of the point in geographic coordinates

Transforms a valid location on the screen (relative to the upper left corner of the map) into world coordinates (like longitude, latitude)

A Rectangle in pixel coordinates to find the geographic equivalent of A Valid IEnvelope that shows the location on the screen

Transforms the specified world location (like latitude, longitude) into a valid screen location (measured in pixels from the upper left corner of the map)

The double horizontal or longitude coordinate The double vertical or latitude coordinate The integer pixel location relative to the left of the control The integer pixel location relative to the top of the control

Transforms the specified world location (like latitude, longitude) into a valid screen location (measured in pixels from the upper left corner of the map)

Transforms the specified world envelope (like latitude, longitude) into a valid screen rectangle (measured in pixels from the upper left corner of the map)

The envelope in geographic coordinates A Rectangle relative to the upper left corner of the control

Gets a graphics surface that is essentially the "white box" area of a map to draw on. By default the GraphicsUnit should be set to world and the PageScale and PageOffset should be set to the appropriate value for world coordinates.

Gets the IEnvelope representing the world coordinate extents of the map

Occurs when the visible region being displayed on the map changes

FastLabelDrawnState

Gets or sets the category

Gets or sets whether the label is selected

Creates a new drawn state with the specified category

The category

ILabelCategory

Returns a shallow copy of this object cast as a LabelCategory.

A shallow copy of this object.

Gets or sets the string expression that controls the integration of field values into the label text. This will not do calculations, but will allow multiple fields to be conjoined in a string expression, substituting a field value where each [FieldName] occurs.

Gets or sets the string filter expression that controls which features that this should apply itself to.

Gets or sets the string name

Gets or sets the text symbolizer to use for this category

ILabelLayer

Clears the current selection, reverting the geometries back to their normal colors.

Expression creates the labels based on the given string expression. Field names in square brackets will be replaced by the values for those fields in the FeatureSet.

Invalidates any cached content for this layer.

Highlights the values from a specified region. This will not unselect any members, so if you want to select a new region instead of an old one, first use ClearSelection. This is the default selection that only tests the anchor point, not the entire label.

An IEnvelope showing a 3D selection box for intersection testing. True if any members were added to the current selection.

Gets or sets the featureSet that defines the text for the labels on this layer.

Gets or sets an optional layer to link this layer to. If this is specified, then drawing will be associated with this layer.

Gets or sets the symbology

Gets or sets the selection symbolizer from the first TextSymbol group.

Gets or sets the regular symbolizer from the first TextSymbol group.

ILabelScheme

Adds a category to the scheme, and also names the category with an integer that has not yet been used.

A new category with a name that has not yet been used

returns a duplicate scheme, where the categories are copied, but the underlying featureset is not duplicated.

A copy of this label scheme

Attempts to reduce the integer index representing this categories rank in the list. By doing this, it will be drawn sooner, and therefore subsequent layers will be drawn on top of this layer, and so it reduces the categories priority. If this collection does not contain the category or it is already at index 0, this will return false.

The ILabelCategory to demote Boolean, true if the demotion was successful

This attempts to increase the numeric index, which will cause it to be drawn later, or higher up on the cue, which means it will be drawn AFTER the previous layers, and therefore is a higher priority. If the category does not exist in the collection or the category is already at the highest value, this returns false.

The category to promote if possible. Boolean, true if the promotion was successful

Gets or sets the list of categories that make up this label scheme

ITextSymbolizer

Uses the properties defined on this symbolizer to return a font.

A new font

Gets or sets the labeling method

Gets or sets the way features with multiple parts are labeled

Gets or sets the the multi-line text alignment in the box.

Gets or set the angle that the font should be drawn in

Gets or set a boolean indicating whether or not should be used

Gets or set the field with angle to draw label

Gets or set a boolean indicating whether or not should be used

Gets or sets the background color

Gets or sets a boolean indicating whether or not a background color should be used

Gets or sets the border color

Gets or sets a boolean indicating whether or not a border should be drawn around the label.

Gets or sets a boolean that will force a shadow to be drawn if this is true.

Gets or sets the color of the actual shadow. Use the alpha channel to specify opacity.

Gets or sets an X and Y geographic offset that is only used if ScaleMode is set to Geographic

Gets or sets an X and Y pixel offset that is used if the ScaleMode is set to Symbolic or Simple.

Gets or sets the string font family name

gets or sets the font size

Gets or sets the font style.

Gets or set the color that the font should be drawn in.

Gets or sets a boolean that governs whether or not to draw a halo.

Gets or sets the color of the halo that surrounds the text.

Gets or sets the X offset in pixels from the center of each feature.

Gets or sets the Y offset in pixels from the center of each feature.

Gets or sets a boolean. If true, as high priority labels are placed, they take up space and will not allow low priority labels that conflict for the space to be placed.

Gets or sets the string field name for the field that controls which labels get placed first. If collision detection is on, a higher priority means will get placed first. If it is off, higher priority will be labeled on top of lower priority.

Gets or sets a boolean. Normally high values from the field are given a higher priority. If this is true, low values are given priority instead.

Gets or sets the position of the label relative to the placement point

Gets or sets the scaling behavior for the text

LabelCategory

Creates a new instance of LabelCategory

Returns the Copy() method cast as an object.

Returns a shallow copy of this category with the exception of the TextSymbolizer, which is duplicated. This uses memberwise clone, so sublcasses using this method will return an appropriate version.

A shallow copy of this object.

Returns the name of this category.

Gets or sets the string filter expression that controls which features that this should apply itself to.

Gets or sets the string name

Gets or sets the text symbolizer to use for this category

LabelDrawState

A LabelCategory interface representing the drawing information for this label.

A boolean indicating whether or not this is selected.

A boolean indicating whether the associated feature should be drawn.

Creates a new instance of the LabelDrawState class where selected is false but visible is true.

The category

Creates a new instance of the LabelDrawState based on the specified parameters.

The category Boolean, true if the label is selected Boolean, true if the label should be visible

LabelLayer

Creates a new instance of LabelLayer

Creates a new layer that uses the attributes from the given featureSet

Creates a new label layer based on the features in the

Clears the current selection, reverting the geometries back to their normal colors.

This builds the _drawnStates based on the current label scheme.

An IEnvelope showing a 3D selection box for intersection testing. True if any members were added to the current selection.

This builds the _drawnStates based on the current label scheme.

Removes the features in the given region

the geographic region to remove the feature from the selection on this layer Boolean true if any features were removed from the selection.

Fires the selection cleared event

Fires the selection extended event

Occurs after the selection has been cleared

Occurs after the selection is updated by the addition of new members

Gets or sets the dictionary that quickly identifies the category for each label.

Gets or sets the indexed collection of drawn states

Gets or sets a valid IList of ILabels. This can just be a List of labels, but allows for custom list development later.

Gets or sets the featureSet that defines the text for the labels on this layer.

Gets or sets an optional layer to link this layer to. If this is specified, then drawing will be associated with this layer. This also updates the FeatureSet property.

Gets or sets the labeling scheme as a collection of categories.

Gets or sets the selection symbolizer from the first TextSymbol group.

Gets or sets the regular symbolizer from the first TextSymbol group.

Methods used in calculating the placement of a label

Use the centroid of the feature

Use the center of the extents of the feature

Use the closest point to the centroid that is in the feature

Determins if all parts should be labeled or just the largest

Label all parts

Only label the largest part

LabelScheme

Creates a new instance of LabelScheme

Adds a category to the scheme, and also names the category with an integer that has not yet been used.

A new category with a name that has not yet been used

Returns the Copy, but as an object.

The ILabelCategory to demote Boolean, true if the demotion was successful

The category to promote if possible. Boolean, true if the promotion was successful

The individual categories are copied, meaning that the text symbolizers will be new, and disconnected from the original text symbolizers of this scheme. MemberwiseClone is used so that any subclass members appended to this will be shallow copies unless this method is overridden.

A Duplicate LabelScheme, but with new, duplicated categories and symbolizers

Gets or sets the Categories

TextSymbolizer

Creates a new instance of TextSymbolizer

Uses the properties defined on this symbolizer to return a font.

A new font

Gets or sets the background color

Gets or sets the border color

Gets or set the color that the font should be drawn in.

Gets or sets the multi-line text alignment in the box. I.e., Control the positioning of the text within the rectangular bounds.

Gets or set the angle that the font should be drawn in

Gets or set a boolean indicating whether or not should be used

Gets or set the field with angle to draw label

Gets or set a boolean indicating whether or not should be used

Gets or sets the background color

Gets or sets a boolean indicating whether or not a background color should be used

Gets or sets the border color

Gets or sets a boolean indicating whether or not a border should be drawn around the label.

Gets or sets a boolean that will force a shadow to be drawn if this is true.

Gets or sets the color of the actual shadow. Use the alpha channel to specify opacity.

Gets or sets an X and Y geographic offset that is only used if ScaleMode is set to Geographic

Gets or sets an X and Y pixel offset that is used if the ScaleMode is set to Symbolic or Simple.

Gets or sets the string font family name

gets or sets the font size

Gets or sets the font style.

Gets or sets the orientation relative to the placement point. I.e., Controls the position of the label relative to the feature.

Gets or set the color that the font should be drawn in.

Gets or sets a boolean that governs whether or not to draw a halo.

Gets or sets the color of the halo that surrounds the text.

Gets or sets the labeling method

Gets or sets the way features with multiple parts are labeled

Gets or sets the X offset in pixels from the center of each feature.

Gets or sets the Y offset in pixels from the center of each feature.

Gets or sets a boolean. If true, as high priority labels are placed, they take up space and will not allow low priority labels that conflict for the space to be placed.

Gets or sets a boolean. Normally high values from the field are given a higher priority. If this is true, low values are given priority instead.

Gets or sets the scaling behavior for the text

This extends the ChangeEventList by providing methods that allow access by an object Key, and will pass

This selects the layer with the specified integer index

THe zero based integer index

Standard Dispose implementation since layers are now disposable.

Adds one request to prevent disposal of this object and its children.

Removes one request to prevent disposal of this object and its children.

Extends the event listeners to include events like ZoomToLayer and VisibleChanged

Occurs when the selection is changed

Ensures that we re-draw the content when inserting new layers

Removes the extended event listeners once a layer is removed from this list.

Fires the LayerRemoved event

Handles the default selection behavior and fires the LayerSelected event.

The integer index of the layer being selected

Fires the LayerSelected event and adjusts the selected state of the layer.

The layer to select Boolean, true if the specified layer is selected

Fires the ItemChanged event and the MembersChanged event and resets any cached lists

Fires the ZoomToLayer method when one of the layers fires its ZoomTo event

The layer to zoom to The extent of the layer

Fires the LayerAdded event

The layer that was added LayerEventArgs

This occurs when the Resume events method is fired.

Fires the selection changed event

the object sender of the event The FeatureLayerSelectionEventArgs of the layer

Finalizes an instance of the LayerEventList class.

Overrides the dispose behavior. If disposeManagedMemory objects is true, then managed objects should be set to null, effectively removing reference counts. If it is false, then only unmanaged memory objects should be removed.

Boolean, true if managed memory objects should be set to null, and if the Dispose method should be called on contained objects.

Occurs if the maps should zoom to this layer.

Occurs when one of the layers in this collection changes visibility.

Occurs when a layer is added to this item.

Occurs when a layer is removed from this item.

Occurs immediately after a layer is selected.

Occurs when the selection on a feature layer changes.

Occurs after the selection has changed, and all the layers have had their selection information updated.

Gets the currently selected layer in this collection.

The envelope that contains all of the layers for this data frame. Essentially this would be the extents to use if you want to zoom to the world view.

Gets a value indicating whether dispose has already been called on this object.

Gets a value indicating whether there are requests to prevent disposal of this object.

Creates a new blank instance of a MapLayer collection. This is especially useful for tracking layers that can draw themselves. This does not concern itself with view extents like a dataframe, but rather is a grouping of layers that is itself also an IMapLayer.

Creates a new layer collection where the parent group is different from the map frame.

Creates a LayerCollection that is not confined in a MapFrame

Occurs when wiring events

Occurs when unwiring events

Given a base name, this increments a number for appending if the name already exists in the collection.

The string base name to start with The base name modified by a number making it unique in the collection

Gets the index of the specified item in this collection if it is a layer

Inserts the specified item into this collection if it is a layer

Adds a range of values

Gets the current count.

Gets the map frame of this layer collection

Gets or sets the ParentGroup for this layer collection, even if that parent group is not actually a map frame.

LayerEnumerator

Creates a new instance of LayerEnumerator

Calls the Dispose method

Moves to the next member

boolean, true if the enumerator was able to advance

Resets to before the first member

Retrieves the current member as an ILegendItem

Returns the current member as an object

LayerEventArgs

Creates a new instance of LayerEventArgs

Gets a layer

This is a class that organizes a list of renderable layers into a single "view" which might be shared by multiple displays. For instance, if you have a map control and a print preview control, you could draw the same data frame property on both, just by passing the graphics object for each. Be sure to handle any scaling or translation that you require through the Transform property of the graphics object as it will ultimately be that scale which is used to back-calculate the appropriate pixel sizes for point-size, line-width and other non-georeferenced characteristics.

The Constructor for the MapFrame object

Draws the layers icon to the legend

Suspends firing the ExtentsChanges event. It only fires if all suspension is gone.

Resumes firing the method, and will fire it automatically if any changes have occurred.

This will create a new layer from the featureset and add it.

Any valid IFeatureSet that does not yet have drawing characteristics

This adjusts the extents when ZoomToLayer is called in one of the internal layers.

Zooms to the envelope if no envelope has been established for this frame.

Fires the ExtentsChanged event

This is responsible for wiring the ZoomToLayer event from any layers in the map frame whenever the layer collection is changed.

This is responsible for unwiring the ZoomToLayer event.

Occurs when the visible region being displayed on the map should update

Occurs after zooming to a specific location on the map and causes a camera recent.

Drawing layers are tracked separately, and do not appear in the legend.

Overrides the default behavior for groups, which should return null in the event that they have no layers, with a more tolerant, getting started behavior where geographic coordinates are assumed.

Gets the container control that this MapFrame belongs to.

Gets the currently selected layer. This will be an active layer that is used for operations.

Controls the smoothing mode. Default or None will have faster performance at the cost of quality.

This should be the geographic extents visible in the map.

This can be used as a component to work as a LayerManager. This also provides the very important DefaultLayerManager property, which is where the developer controls what LayerManager should be used for their project.

Creates a new instance of the LayerManager class. A data manager is more or less just a list of data providers to use. The very important LayerManager.DefaultLayerManager property controls which LayerManager will be used to load data. By default, each LayerManager sets itself as the default in its constructor.