PopupAttachmentManager Class

Member Function Documentation

PopupAttachmentManager::PopupAttachmentManager(Esri::ArcGISRuntime::ArcGISFeature *arcGISFeature, QObject *parent = nullptr)

Constructor that takes an arcGISFeature with an optional parent.

[signal] void PopupAttachmentManager::addAttachmentCompleted(QUuid taskId, Esri::ArcGISRuntime::PopupAttachment *popupAttachment)

Signal emitted when an attachment from a local file has been added.

• taskId - The task ID for the asynchronous operation.
• popupAttachment - The PopupAttachment that has been added.

The returned PopupAttachment object has the PopupAttachmentManager as its parent.

See also Returned QObjects Parenting.

[signal] void PopupAttachmentManager::applyChangesCompleted(QUuid taskId, Esri::ArcGISRuntime::Error error)

Signal emitted when attachment changes are applied from the PopupAttachmentManager to the ArcGISFeature in the ArcGISFeatureTable.

• taskId - The task ID for the asynchronous operation.
• error - The Error object.

[signal] void PopupAttachmentManager::fetchAttachmentsCompleted(QUuid taskId, const QList<Esri::ArcGISRuntime::PopupAttachment *> &popupAttachments)

Signal emitted when the attachments have been fetched from the ArcGISFeature.

• taskId - The task ID for the asynchronous operation.
• popupAttachments - A list of PopupAttachments obtained from the ArcGISFeature.

The returned PopupAttachment objects have the PopupAttachmentManager as their parent.

See also Returned QObjects Parenting.

[override virtual] PopupAttachmentManager::~PopupAttachmentManager()

Destructor.

QUuid PopupAttachmentManager::addAttachment(const QUrl &localFilePath, const QString &contentType, const QString &name)

Asynchronously adds an attachment to the PopupAttachmentManager.

You must call applyChanges to apply the edits from the PopupAttachmentManager to the associated ArcGISFeatureTable. To undo any edits, call revertChanges.

• localFilePath - The URL to the local data.
• contentType - The type of data.
• name - The name of the attachment.

The addAttachmentCompleted signal emits when this asynchronous operation completes. Use the returned QUuid to keep track of concurrent operations.

Esri::ArcGISRuntime::PopupAttachment *PopupAttachmentManager::addAttachment(const QImage &image, const QString &contentType, const QString &name)

Adds an attachment image to the PopupAttachmentManager.

You must call applyChanges to apply the edits from the PopupAttachmentManager to the associated ArcGISFeatureTable. To undo any edits, call revertChanges.

• image - The image to add as an attachment.
• contentType - The type of data.
• name - The name of the attachment.

Note: This is a synchronous operation.

Esri::ArcGISRuntime::PopupAttachment *PopupAttachmentManager::addAttachment(const QByteArray &data, const QString &contentType, const QString &name)

Adds an attachment to the PopupAttachmentManager.

You must call applyChanges to apply the edits from the PopupAttachmentManager to the associated ArcGISFeatureTable. To undo any edits, call revertChanges.

• data - The byte array of the data.
• contentType - The type of data.
• name - The name of the attachment.

Note: This is a synchronous operation.

QUuid PopupAttachmentManager::applyChanges()

Applies the current changes in the PopupAttachmentManager to the ArcGISFeature in its ArcGISFeatureTable.

The applyChangesCompleted signal emits when this asynchronous operation completes. Use the returned QUuid to keep track of concurrent operations.

QList<Esri::ArcGISRuntime::PopupAttachment *> PopupAttachmentManager::attachments() const

Returns a list of all the PopupAttachments in the PopupAttachmentManager.

Esri::ArcGISRuntime::PopupAttachmentListModel *PopupAttachmentManager::attachmentsModel() const

A model that can be used to display popup attachment information in a view.

Any changes made by the PopupAttachmentManager will be reflected immediately by the model.

Note: Getter function for property attachmentsModel.

This function was introduced in Esri::ArcGISRuntime 100.1.

void PopupAttachmentManager::deleteAttachment(Esri::ArcGISRuntime::PopupAttachment *popupAttachment)

Deletes the given popupAttachment from the PopupAttachmentManager.

You must call applyChanges to apply the edits from the PopupAttachmentManager to the associated ArcGISFeatureTable. To undo any edits, call revertChanges.

QUuid PopupAttachmentManager::fetchAttachments()

Fetches the Attachments from the ArcGISFeature and creates PopupAttachments from them.

The fetchAttachmentsCompleted signal emits when this asynchronous operation completes. Use the returned QUuid to keep track of concurrent operations.

QList<Esri::ArcGISRuntime::PopupAttachment *> PopupAttachmentManager::filterAttachments() const

Returns a filtered list of popup attachments in the PopupAttachmentManager in an alphabetically ascending order by name (read-only).

This list only includes attachments with specific content types, which are:

• "image/jpg"
• "image/jpeg"
• "image/pjpeg"
• "image/png"
• "image/gif"
• "video/quicktime"
• "application/pdf"
• "application/vnd.ms-excel"
• "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
• "application/msword"
• "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
• "application/vnd.ms-powerpoint"
• "application/vnd.openxmlformats-officedocument.presentationml.presentation"
• "text/html"

void PopupAttachmentManager::revertChanges()

Reverts the current working changes made to the Popup's attachments (such as addAttachment and deleteAttachment).

This does not reverse a call to applyChanges.