Kml Screen Overlay
A KML ScreenOverlay object. KML ScreenOverlay is an image overlay fixed to the screen. ScreenOverlays may be used for compasses, logos and heads-up displays.
Since
200.1.0
Constructors
Creates a screen overlay with the specified icon. If the icon is null, a rectangle is drawn using the color and size defined by KmlScreenOverlay.color and KmlScreenOverlay.size.
Properties
The KML screen overlay icon. If the icon is null, a rectangle is drawn using the color and size defined by KmlScreenOverlay.color and KmlScreenOverlay.size.
Specifies a point on (or outside of) the overlay image that is mapped to the screen coordinate (KmlScreenOverlay.screenCoordinate). It requires x and y values, and the units for those values. The x and y values can be specified in three different ways: as pixels ("pixels"), as fractions of the image ("fraction"), or as inset pixels ("insetPixels"), which is an offset in pixels from the upper right corner of the image. The x and y positions can be specified in different ways—for example, x can be in pixels and y can be a fraction. The origin of the coordinate system is in the lower left corner of the image. If not specified, the default is the center of the overlay image.
Indicates the angle of rotation of the parent object. A value of 0 means no rotation. The value is an angle in degrees counterclockwise starting from north. The center of the rotation, if not specified in rotation coordinate (KmlScreenOverlay.rotationCoordinate), is the center of the overlay image.
Point relative to the screen about which the screen overlay is rotated. If not specified, the rotation point is the center of the screen.
Specifies a point relative to the screen origin that the overlay image is mapped to. The x and y values can be specified in three different ways: as pixels ("pixels"), as fractions of the screen ("fraction"), or as inset pixels ("insetPixels"), which is an offset in pixels from the upper right corner of the screen. The x and y positions can be specified in different ways—for example, x can be in pixels and y can be a fraction. The origin of the coordinate system is in the lower left corner of the screen. If not specified, the default is the center of the screen.
Specifies the size of the image for the screen overlay. A value of −1 indicates to use the native dimension A value of 0 indicates to maintain the aspect ratio A value of n sets the value of the dimension For example: A x value of -1 and y value of -1 in fractions indicates the image size equals its original x and y dimensions. A x value of -1 and y value of 0.2 in fractions indicates the image size equals its original x dimension and 20% of its y dimension. A x value of 100 and y value of 500 in pixels indicates the image is of size 100 pixels by 500 pixels. If not specified, the default is the original size of the image.
Inherited properties
The color to be used for the KML node balloon. A color mask that can be used to color the balloon of a KML node. This color can be used for the UI "chrome" that presents the KmlNode.balloonContent, such as the background color of a callout.
The balloon content that should be displayed in a balloon popup for the KML node. The provided HTML is suitable for display in a web view.
The description of the KML node.
The non-schema data present in the extended data of a KML node.
A collection of schema data present in the extended data of a KML node. Adding a unique KmlSchemaData.schema object also adds it to KmlDocument.schemas.
The KML node's highlight style. This style is used when the KML node has been highlighted / selected.
True if the KML node is highlighted, false otherwise. This controls whether the default style or an alternate 'highlighted' style (if present) is used for rendering the node. All of the connected map views will be updated. This is unrelated to the concept of selection in this API.
True if the KML node is visible, false otherwise. In order for a node to be visible, all of its ancestors must also be visible. Changing the visibility of one node may affect visibility of other nodes in the dataset hierarchy, such as child nodes. All of the connected map views will be updated.
The KML node's parent.
The KML node's refresh status. Use the node refresh status to update the node's properties and update application UI.
The KML node's snippet. Snippets can be defined for KML nodes as an additional short description for UI display. If no snippet is specified, you can take the first few lines of the KmlNode.description. The maximum number of lines to display is specified by the KmlNode.snippetMaxLines property.
The maximum number of lines of snippet to be shown in the UI.
The KML node's time extent. Represents the com.arcgismaps.mapping.TimeExtent equivalent of a KML node's TimeStamp or TimeSpan. A KmlContainer node such as KmlDocument or KmlFolder may have its own com.arcgismaps.mapping.TimeExtent independent of its child nodes. All KML TimeStamps and TimeSpans specified in a KML/KMZ file are converted to their UTC com.arcgismaps.mapping.TimeExtent equivalents.
The UX icon of a KML node. Use this icon to represent the KML node in the TOC or list item or any UI element.
The color mask used to tint the node's icon. A color mask that can be used to blend the image associated with the KML node. Pixels in the image are multiplied by this color channel-by-channel. Colors in KML are specified in ABGR order. When no UX icon is specified, you can use this color to draw a placeholder for use in the UI (for example, a legend). UX icons are not pre-tinted; it is the application's responsibility to apply the tint color to the UX icon before displaying it.
The KML node's viewpoint. The KML viewpoint is the specified vantage point for looking at the node. This can be used to zoom to a node (for example, if a user selected it in a TOC).
Inherited functions
Saves the node and any referenced local files into a zipped KMZ archive. The node will be saved to a KMZ file to ensure that any referenced files are available locally when sharing the file with others. If this method is called on a leaf node (e.g. KMLPlacemark, KMLGroundOverlay, etc), only that node and its referenced files will be saved. If this method is called on container node (e.g. KMLDocument, KMLFolder), the node and all of its children and referenced files will be saved. If this method is called on a KMLNetworkLink, the link will be saved but the children will not. This is because the children will simply be refetched when the saved KMLNetworkLink is loaded. Saving referenced files will differ based on the type of reference. For HTTP paths, the path will be saved as is but the referenced file will not be zipped into the archive, as it will simply be refetched when the new KMZ is loaded. For relative paths, the path will be saved as is and the referenced file will be zipped relative to the root of the KMZ file. For absolute paths, the path will be converted to a relative path, and the referenced file will be zipped into a "files" folder at the root of the KMZ file. For example, "C:/icons/some_icon.png" would be converted to "files/some_icon.png" and stored at that location in the KMZ file. The filename supports unicode characters as well as nested directories. It must be non-empty and there must not be an existing file located there. Saving a node to a KMZ file requires an ArcGIS Runtime 'Standard' license level.