Obsolete Members for KmlNode

  • KmlNode
  • 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 to files/some_icon.png and stored at that location in the KMZ 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.

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.