The following members of class ArcGISRuntime are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.
Classes
(since Esri::ArcGISRuntime 100.1, deprecated) class | PopupAttachmentListModel |
(since Esri::ArcGISRuntime 100.0, deprecated) class | PopupAttachmentManager |
(since Esri::ArcGISRuntime 100.0, deprecated) class | PopupAttributeListModel |
(since Esri::ArcGISRuntime 100.0, deprecated) class | PopupManager |
(since Esri::ArcGISRuntime 100.12, deprecated) class | SketchEditConfiguration |
(since Esri::ArcGISRuntime 100.12, deprecated) class | SketchEditor |
(since Esri::ArcGISRuntime 100.12, deprecated) class | SketchStyle |
(since Esri::ArcGISRuntime 100.12, deprecated) class | SketchVertex |
(since Esri::ArcGISRuntime 100.0, deprecated) class | TaskWatcher |
Types
(since Esri::ArcGISRuntime 100.12, deprecated) enum class | SketchCreationMode { Unknown, Point, Polyline, Polygon, Multipoint } |
(since Esri::ArcGISRuntime 100.12, deprecated) enum class | SketchResizeMode { None, Stretch, Uniform } |
(since Esri::ArcGISRuntime 100.12, deprecated) enum class | SketchVertexEditMode { InteractionEdit, SelectOnly } |
Classes
[since Esri::ArcGISRuntime 100.1, deprecated]
class ArcGISRuntime::PopupAttachmentListModel
This class is deprecated. We strongly advise against using it in new code.
Obtain a PopupAttachmentListModel from a PopupAttachmentManager.
The model will automatically fetch attachments from the underlying features so that they can be displayed in a view.
This class is a subclass of QAbstractListModel.
The model returns data for the following roles:
Role | Type | Description | PopupAttachmentRoles |
---|---|---|---|
name | QString | The name of the attachment. | PopupAttachmentNameRole |
contentType | QString | The MIME type of the attachment file. | PopupAttachmentContentTypeRole |
size | int | The size of the attachment in bytes. | PopupAttachmentSizeRole |
local | bool | Whether the data for the attachments has been downloaded locally. | PopupAttachmentLocalRole |
attachmentUrl | QUrl | The URL of the attachment. | PopupAttachmentAttachmentUrlRole |
popupType | Esri::ArcGISRuntime::PopupAttachmentType | The type of popup attachment. | PopupAttachmentPopupTypeRole |
editState | Esri::ArcGISRuntime::PopupAttachmentEditState | The popup attachment edit state. | PopupAttachmentEditStateRole |
thumbnailUrl | QUrl | The URL to the thumbnail. | PopupAttachmentThumbnailUrlRole |
fullImageUrl | QUrl | The URL to the full image. | PopupAttachmentFullImageUrlRole |
This class was introduced in Esri::ArcGISRuntime 100.1.
[since Esri::ArcGISRuntime 100.0, deprecated]
class ArcGISRuntime::PopupAttachmentManager
This class is deprecated. We strongly advise against using it in new code.
In addition to the available constructors on PopupAttachmentManager, you can obtain a PopupAttachmentManager from PopupManager::attachmentManager.
This class was introduced in Esri::ArcGISRuntime 100.0.
[since Esri::ArcGISRuntime 100.0, deprecated]
class ArcGISRuntime::PopupAttributeListModel
This class is deprecated. We strongly advise against using it in new code.
Obtain a PopupAttributeListModel from the PopupManager.
The model returns data for the following roles:
Role | Type | Description | SublayerRoles |
---|---|---|---|
fieldName | QString | The field name for the PopupField. | PopupAttributeFieldNameRole |
fieldValue | QVariant | The value for the PopupField. | PopupAttributeFieldValueRole |
popupDateFormat | PopupDateFormat | The PopupDateFormat for the PopupField. | PopupAttributePopupDateFormatRole |
decimalPlaces | int | The number of decimal places to display for numerical fields. | PopupAttributeDecimalPlacesRole |
isUseThousandsSeparator | bool | If the thousands separator should be used. | PopupAttributeIsUseThousandsSeparatorRole |
isEditable | bool | Whether the PopupField is editable. | PopupAttributeIsEditableRole |
isVisible | bool | Whether the PopupField is visible. | PopupAttributeIsVisibleRole |
isNullable | bool | Whether the PopupField is nullable. | PopupAttributeIsNullableRole |
label | QString | The PopupField label. | PopupAttributeLabelRole |
popupStringFieldOption | PopupStringFieldOption | The PopupStringFieldOption for the PopupField. | PopupAttributePopupStringFieldOptionRole |
tooltip | QString | The tooltip for the PopupField. | PopupAttributeTooltipRole |
formattedValue | QString | The formatted value for the PopupField. | PopupAttributeFormattedValueRole |
fieldType | FieldType | The FieldType for the PopupField. | PopupAttributeFieldTypeRole |
maxLength | int | The maxmimum length for the PopupField. | PopupAttributeMaxLengthRole |
isFeatureType | bool | Whether the PopupField is a feature type. | PopupAttributeIsFeatureTypeRole |
validationErrorText | QString | The validation error text if there is any. | PopupAttributeValidationErrorTextRole |
rangeDomainValidationText | QString | The range domain validation text if applicable. | PopupAttributeRangeDomainValidationTextRole |
useThousandsSeparator | QString | If the thousands separator should be used (since 100.1). | PopupAttributeUseThousandsSeparatorRole |
editable | bool | Whether the PopupField is editable (since 100.1). | PopupAttributeEditableRole |
attributeVisible | bool | Whether the PopupField is visible (since 100.1). | PopupAttributeAttributeVisibleRole |
nullable | bool | Whether the PopupField is nullable (since 100.1). | PopupAttributeNullableRole |
featureType | bool | Whether the PopupField is a feature type (since 100.1). | PopupAttributeFeatureTypeRole |
This class was introduced in Esri::ArcGISRuntime 100.0.
[since Esri::ArcGISRuntime 100.0, deprecated]
class ArcGISRuntime::PopupManager
This class is deprecated. We strongly advise against using it in new code.
This class works in conjunction with the PopupView in the ArcGIS Maps SDK Toolkit. The PopupView is used to display information about a GeoElement. For example, a PopupView could be used to display the attributes of an ArcGISFeature that is stored in a Feature Service. PopupManager provides the PopupView with the content to display in the view. It also contains many helper functions and properties to assist the PopupView with displaying and editing information related to the associated GeoElement.
An example workflow for displaying a PopupView using a PopupManager would be:
- Declare a PopupView and anchor it to a desired location.
- Perform an identify operation on a GeoView and select a Feature from the identify result.
- Create a Popup from the Feature.
- Optionally obtain the Popup's PopupDefinition and set the title, whether to show attachments, and so on.
- Create a PopupManager from the Popup.
- Assign the PopupView's
popupManager
property the PopupManager created in the previous step. - Call the
show()
method to display the PopupView. - Call the
dismiss()
method to hide the PopupView.
Note: Each time a change is made to the Popup, PopupDefinition, PopupManager, or any of their properties, the PopupManager must be re-set to the PopupView.
In order to use the PopupManager with a QML UI, the PopupManager, PopupAttachmentManager, PopupAttachmentListModel, and PopupAttributeListModel classes must be registered as QML Types. For example, the following lines could be added to the main.cpp
to register the classes under the Esri.Samples
namespace:
qmlRegisterUncreatableType<PopupManager>("Esri.Samples", 1, 0, "PopupManager", "PopupManager is uncreateable"); qmlRegisterUncreatableType<PopupAttachmentManager>("Esri.Samples", 1, 0, "PopupAttachmentManager", "PopupAttachmentManager is uncreateable"); qmlRegisterUncreatableType<PopupAttributeListModel>("Esri.Samples", 1, 0, "PopupAttributeListModel", "PopupAttributeListModel is uncreateable"); qmlRegisterUncreatableType<PopupAttachmentListModel>("Esri.Samples", 1, 0, "PopupAttachmentListModel", "PopupAttachmentListModel is uncreateable");
Note: The default PopupView provided with the toolkit is built with Qt Quick for a QML UI. If using Qt Widgets, a custom Widgets UI could be created to consume the information provided by PopupManager.
Relevant samples:
- Display clusters: Display a web map with a point feature layer that has feature reduction enabled to aggregate points into clusters.
- Show popup: Show predefined popups from a web map.
This class was introduced in Esri::ArcGISRuntime 100.0.
[since Esri::ArcGISRuntime 100.12, deprecated]
class ArcGISRuntime::SketchEditConfiguration
This class is deprecated. We strongly advise against using it in new code.
since Esri::ArcGISRuntime 200.2
SketchEditor and associated types are deprecated. Use GeometryEditor instead.
This class was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.12, deprecated]
class ArcGISRuntime::SketchEditor
This class is deprecated. We strongly advise against using it in new code.
Instances of this class represent a sketch editor that allows the user to interactively sketch geometries. You can sketch point, polygon, and polyline geometries from scratch, modify existing geometries, insert and remove vertices, undo and redo changes, and so on.
The sketch editor must be set on the view using MapView::setSketchEditor and then started to perform the sketch based on user interactions.
A new GeometryEditor class provides a successor to this class, supporting a wider array of use cases and providing a foundation for additional future geometry editing capabilities. If starting new development, use GeometryEditor in preference to SketchEditor.
since Esri::ArcGISRuntime 200.2
Use GeometryEditor instead.
Relevant samples:
- Sketch on map: This sample demonstrates how to use the Sketch Editor to edit or sketch a new point, line, or polygon geometry on to a map.
This class was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.12, deprecated]
class ArcGISRuntime::SketchStyle
This class is deprecated. We strongly advise against using it in new code.
since Esri::ArcGISRuntime 200.2
SketchEditor and associated types are deprecated. Use GeometryEditor instead.
This class was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.12, deprecated]
class ArcGISRuntime::SketchVertex
This class is deprecated. We strongly advise against using it in new code.
If the pointIndex is greater or equal to 0, then it is a vertex. If the insertionIndex is greater or equal to 0, then it is a mid-vertex. This object cannot have both pointIndex and insertionIndex greater or equal to 0. When the associated sketch editor is modifying a point geometry, the partIndex and pointIndex will both be 0 for a valid vertex. Mid-vertices are not allowed for a single point geometry. When the associated sketch editor is modifying a multi-point geometry, the partIndex will be 0 for a valid vertex. Mid-vertices are not allowed for a multi-point geometry.
since Esri::ArcGISRuntime 200.2
SketchEditor and associated types are deprecated. Use GeometryEditor instead.
This class was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.0, deprecated]
class ArcGISRuntime::TaskWatcher
This class is deprecated. We strongly advise against using it in new code.
TaskWatcher supports examining the state of a task along with the ability to cancel a task.
This class is only copyable for convenience. All copies are shallow copies and reference the same underlying task.
since Esri::ArcGISRuntime 200.2
This class was introduced in Esri::ArcGISRuntime 100.0.
Type Documentation
[since Esri::ArcGISRuntime 100.12, deprecated]
enum class SketchCreationMode
This enum is deprecated. We strongly advise against using it in new code.
Enumerates the type of geometry and how it will be created by the SketchEditor.
Constant | Value | Description |
---|---|---|
SketchCreationMode::Unknown | -1 | Unknown geometry. |
SketchCreationMode::Point | 0 | Sketches a Point geometry. |
SketchCreationMode::Polyline | 1 | Sketches a Polyline geometry incrementally vertex by vertex. |
SketchCreationMode::Polygon | 2 | Sketches a Polygon geometry incrementally vertex by vertex. |
SketchCreationMode::Multipoint | 10 | Sketches a Multipoint geometry. |
This enum was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.12, deprecated]
enum class SketchResizeMode
This enum is deprecated. We strongly advise against using it in new code.
Describes how geometry is resized to fill its allocated space while editing geometry.
The SketchResizeMode can be one of:
Constant | Value | Description |
---|---|---|
SketchResizeMode::None | 0 | The geometry preserves its original size. |
SketchResizeMode::Stretch | 1 | The geometry is resized to fill the destination dimensions. The aspect ratio is not preserved. |
SketchResizeMode::Uniform | 2 | The geometry is resized to fill the destination dimensions while it preserves its native aspect ratio. |
This enum was introduced in Esri::ArcGISRuntime 100.12.
[since Esri::ArcGISRuntime 100.12, deprecated]
enum class SketchVertexEditMode
This enum is deprecated. We strongly advise against using it in new code.
Describes how vertices respond to user interaction.
The SketchVertexEditMode can be one of:
Constant | Value | Description |
---|---|---|
SketchVertexEditMode::InteractionEdit | 0 | Selection state and location of vertex can be updated through user interaction (i.e. tap, drag). |
SketchVertexEditMode::SelectOnly | 1 | Only selection state of vertex can be updated through user interaction. |
This enum was introduced in Esri::ArcGISRuntime 100.12.