The following members of class KmlNode are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.
Public Functions
(deprecated) Esri::ArcGISRuntime::TaskWatcher | saveAs(const QString &kmzFile) |
Signals
(deprecated) void | saveAsCompleted(const QUuid &taskId) |
Member Function Documentation
[since Esri::ArcGISRuntime 100.6]
Esri::ArcGISRuntime::TaskWatcher KmlNode::saveAs (const QString &kmzFile )
This function is deprecated. We strongly advise against using it in new code.
Saves the node and any referenced local files into a zipped KMZ archive at local file path specified in kmzFile.
The node is saved to a KMZ
file to ensure that any referenced files are available locally when sharing the KMZ
file with others.
- When this method is called on a leaf node (e.g. KmlPlacemark, KmlGroundOverlay, and so on), only that node and its referenced files are saved.
- When this method is called on a container node (e.g. KmlDocument, KmlFolder), the node and all of its children and referenced files are saved.
- When this method is called on a KmlNetworkLink, the link is saved but the children are not. This is because the children will be refetched when the saved KmlNetworkLink is loaded.
Saving referenced files will differ based on the type of path used for reference.
- For HTTP paths, the path is saved as-is but the referenced file is not zipped into the archive, as it will be refetched when the new
KMZ
file is loaded. - For relative paths, the path is saved as-is and the referenced file is zipped relative to the root of the
KMZ
file. - For absolute paths, the path is converted to a relative path, and the referenced file is zipped into a "files" folder at the root of the
KMZ
file. For example,C:/icons/some_icon.png
is converted tofiles/some_icon.png
and stored at that location in theKMZ
file.
The filename supports Unicode characters as well as nested directories
The saveAsCompleted signal is fired when a saveAs operation completes.
This function was introduced in Esri::ArcGISRuntime 100.6.
[signal]
void KmlNode::saveAsCompleted (const QUuid &taskId )
This function is deprecated. We strongly advise against using it in new code.
The signal emitted when the saveAs task with the ID taskId completes.