ArcGIS Runtime SDK for iOS
100.15
|
A KML Screen Overlay element.
An instance of this class represents a KML <ScreenOverlay> element which draws an image overlay at a fixed screen location. Screen overlays may be used for compasses, logos and heads-up displays.
Instance Methods | |
(instancetype) | - initWithIcon: |
(id< AGSCancelable >) | - saveToFileURL:completion: |
Class Methods | |
(instancetype) | + KMLNode |
(instancetype) | + KMLScreenOverlayWithIcon: |
Properties | |
NSString * | address |
AGSColor * | balloonBackgroundColor |
NSString * | balloonContent |
AGSColor * | color |
NSInteger | drawOrder |
AGSEnvelope * | extent |
BOOL | highlighted |
AGSKMLStyle * | highlightStyle |
AGSKMLIcon * | icon |
NSString * | name |
NSString * | nodeDescription |
NSString * | nodeID |
AGSKMLImageCoordinate * | overlayCoordinate |
AGSKMLNode * | parentNode |
NSError * | refreshError |
AGSKMLRefreshStatus | refreshStatus |
double | rotation |
AGSKMLImageCoordinate * | rotationCoordinate |
AGSKMLImageCoordinate * | screenCoordinate |
AGSKMLImageCoordinate * | size |
NSString * | snippet |
NSInteger | snippetMaxLines |
AGSKMLStyle * | style |
AGSTimeExtent * | timeExtent |
AGSImage * | UXIcon |
AGSColor * | UXIconColor |
NSInteger | UXIconID |
AGSKMLViewpoint * | viewpoint |
BOOL | visible |
- (instancetype) initWithIcon: | (nullable AGSKMLIcon *) | icon |
Creates a screen overlay with the specified icon.
icon | The icon associated to the screen overlay. |
+ (instancetype) KMLNode |
+ (instancetype) KMLScreenOverlayWithIcon: | (nullable AGSKMLIcon *) | icon |
Creates a screen overlay with the specified icon.
icon | The icon associated to the screen overlay. |
|
readwritenonatomiccopyinherited |
The address of the KML node. Represents an unstructured address such as a street, city, state address, and/or a postal code.
|
readnonatomicstronginherited |
The KML node's balloon background color, which should be used when showing a popup.
balloonContent
, such as the border and background of a Callout.
|
readnonatomiccopyinherited |
The content that should be displayed in a balloon popup of the KML node as HTML.
|
readwritenonatomicstrong |
A color mask that is used to blend the image associated with screen overlay.
|
readwritenonatomicassign |
The KML screen overlay's draw order. It defines the stacking order for the images in overlapping overlays. Overlays with higher drawOrder values are drawn on top of overlays with lower drawOrder values.
|
readnonatomicstronginherited |
The KML node's bounding extent.
|
readwritenonatomicassigninherited |
Indicates whether the KML node is highlighted. This controls whether the default style or an alternate 'highlighted' style (if present) is used for rendering the node.
|
readwritenonatomicstronginherited |
The KML node's highlight style. This style is used when the KML node has been highlighted / selected.
AGSKMLStyle
|
readwritenonatomicstrong |
The KML scene overlay's icon.
|
readwritenonatomiccopyinherited |
The name of the KML node.
|
readwritenonatomiccopyinherited |
The description of the KML node.
|
readwritenonatomiccopyinherited |
The ID of the KML node.
|
readwritenonatomicstrong |
Specifies a point on (or outside of) the overlay image that is mapped to the screen coordinate (AGSKMLScreenOverlay::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.
|
readnonatomicstronginherited |
The KML node's parent or nil
if the node is a root node.
|
readnonatomicstronginherited |
The error that was encountered during the most recent KML node refresh operation. Will be nil if the operation succeeded. The refresh error changes can be monitored using Key-Value Observing (KVO).
|
readnonatomicassigninherited |
The refresh status of the KML node. The refresh status changes can be monitored using Key-Value Observing (KVO). Use this to update the node's properties and application UI. Please take following actions for different refresh statuses, AGSKMLRefreshStatusNone - No action required. AGSKMLRefreshStatusInProgress - Application may show an appropriate UI, such as a spinning wheel on top of the node's table of contents (TOC) icon to indicate in progress status and to restrict user interaction with the node. AGSKMLRefreshStatusCompleted - Read and update the node's properties and its children. The AGSKMLNetworkLink::childNodes
changes can be monitored using Key-Value Observing (KVO). AGSKMLRefreshStatusFailed - Check refreshError
to get the reason for failure and show the error message. Also, applications may show an appropriate UI cue such as a red X with the node's TOC icon to indicate the failed status.
|
readwritenonatomicassign |
Indicates the angle of rotation of the parent object. A value of 0 means no rotation. The value is an angle in degrees counter clockwise starting from north. The center of the rotation, if not specified in rotation coordinate (AGSKMLScreenOverlay::rotationCoordinate
), is the center of the overlay image.
|
readwritenonatomicstrong |
Point relative to the screen about which the screen overlay is rotated. If not specified, the rotation point is the center of the screen.
|
readwritenonatomicstrong |
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.
|
readwritenonatomicstrong |
Specifies the size of the image for the screen overlay. 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.
|
readwritenonatomiccopyinherited |
The KML node's snippet, if specified.
|
readwritenonatomicassigninherited |
The maximum number of lines of snippet to be shown in the UI.
|
readwritenonatomicstronginherited |
|
readwritenonatomicstronginherited |
The KML node's time extent.
Represents the AGSTimeExtent
equivalent of a KML node's TimeStamp or TimeSpan. An AGSKMLContainer
node such as AGSKMLDocument
or AGSKMLFolder
may have its own AGSTimeExtent
independent of its child nodes. All KML TimeStamps and TimeSpans specified in a KML/KMZ file are converted to their UTC AGSTimeExtent
equivalents.
Examples:
KML TimeStamp | AGSTimeExtent::startTime | AGSTimeExtent::endTime |
---|---|---|
2021 | 2021-01-01T00:00:00 | 2021-12-31T23:59:59 |
2021-01 | 2021-01-01T00:00:00 | 2021-01-31T23:59:59 |
2021-01-01 | 2021-01-01T00:00:00 | 2021-01-01T23:59:59 |
2021-01-01T12:34:56 | 2021-01-01T12:34:56 | 2021-01-01T12:34:56 |
KML TimeSpan | AGSTimeExtent::startTime | AGSTimeExtent::endTime |
---|---|---|
2021 - 2022 | 2021-01-01T00:00:00 | 2022-12-31T23:59:59 |
2021-01 - 2021-02 | 2021-01-01T00:00:00 | 2021-02-28T23:59:59 |
No beginning - 2021 | Infinite start time | 2021-12-31T23:59:59 |
2021 - No end | 2021-01-01T00:00:00 | Infinite end time |
AGSTimeExtent
|
readnonatomicstronginherited |
The KML node's UX icon. Use this icon to represent the KML node in the table of contents (TOC) or anywhere else you need to display the node in the UI. The icon changes can be monitored using Key-Value Observing (KVO).
|
readnonatomicstronginherited |
The color mask that can be used to blend the image associated with UXIcon
. Pixels in the image are multiplied by this color channel-by-channel.
nil
), you can use the icon color to draw a placeholder image in the UI (for example, the TOC). UXIcon
; it is the application's responsibility to tint the image before displaying it.
|
readnonatomicassigninherited |
The ID of KML node's UX icon.
|
readwritenonatomicstronginherited |
The KML node's viewpoint, or nil
if no Camera or LookAt viewpoint is specified on the node. It specifies the vantage point for looking at the node. This can be used to show a particular node in the view (for example, if a user selected it in a TOC).
|
readwritenonatomicassigninherited |
Indicates whether the KML node is visible or not.
true
. Changing the visibility of one node may affect the other nodes in the dataset's node hierarchy, including child nodes.