EncExchangeSet Class

  • EncExchangeSet
  • class Esri::ArcGISRuntime::EncExchangeSet

    An Electronic Navigation Chart (ENC) exchange set object. More...

    Header: #include <EncExchangeSet.h>
    Since: Esri::ArcGISRuntime 100.2
    Inherits: Esri::ArcGISRuntime::Object and Esri::ArcGISRuntime::Loadable

    Public Functions

    EncExchangeSet(const QStringList &paths, QObject *parent = nullptr)
    virtual ~EncExchangeSet() override
    QList<Esri::ArcGISRuntime::EncDataset *> datasets() const
    QStringList paths() const
    QString readme() const

    Reimplemented Public Functions

    virtual void cancelLoad() override
    virtual void load() override
    virtual Esri::ArcGISRuntime::Error loadError() const override
    virtual Esri::ArcGISRuntime::LoadStatus loadStatus() const override
    virtual void retryLoad() override

    Signals

    void doneLoading(const Esri::ArcGISRuntime::Error &loadError)
    void loadStatusChanged(Esri::ArcGISRuntime::LoadStatus loadStatus)

    Detailed Description

    An exchange set is a package of files that contains one catalog file and at least one S-57 dataset file. An exchange set may be created using the S-57 tools in ArcGIS Desktop's Nautical Toolbox.

    // create EncExchangeSet using paths
    auto* encExchangeSet = new EncExchangeSet(paths, parent);
    
    // get the list of EncDataset
    QList<EncDataset*> EncDatasets = encExchangeSet->datasets();
    
    // display the names of EncDataset
    for (EncDataset* EncDataset : EncDatasets)
    {
      qDebug() << EncDataset->name();
    }

    Relevant samples:

    See also Loadable and EncLayer.

    Member Function Documentation

    [explicit] EncExchangeSet::EncExchangeSet(const QStringList &paths, QObject *parent = nullptr)

    Creates an ENC exchange set object.

    • paths - The paths to ENC exchange sets to be loaded.
    • parent - The optional parent QObject.

    [override virtual] EncExchangeSet::~EncExchangeSet()

    Destructor.

    [override virtual] void EncExchangeSet::cancelLoad()

    Reimplements: Loadable::cancelLoad().

    Cancels loading metadata for the object

    See Loadable.

    Subsequent loads of an exchange set and the component data sets will not read the cell information. Instead, this API will load the data from the internal SENC database.

    QList<Esri::ArcGISRuntime::EncDataset *> EncExchangeSet::datasets() const

    Returns the ENC datasets that are part of the exchange set.

    ENC exchange sets consist of one or more datasets and a catalog. The exchange set's datasets can be used to create EncCell objects, which can be used to create EncLayer objects for display in a map.

    [signal] void EncExchangeSet::doneLoading(const Esri::ArcGISRuntime::Error &loadError)

    Signal emitted when this object is done loading.

    • loadError - Details about any error that may have occurred.

    Note: If there is a load error it will also be emitted on the errorOccurred signal.

    See also Loadable and Object.

    [override virtual] void EncExchangeSet::load()

    Reimplements: Loadable::load().

    Loads the metadata for the object asynchronously.

    See Loadable.

    [override virtual] Esri::ArcGISRuntime::Error EncExchangeSet::loadError() const

    Reimplements: Loadable::loadError() const.

    Returns the load error.

    See Loadable.

    See also Error.

    [override virtual] Esri::ArcGISRuntime::LoadStatus EncExchangeSet::loadStatus() const

    Reimplements: Loadable::loadStatus() const.

    Returns the load status.

    See Loadable.

    See also LoadStatus.

    [signal] void EncExchangeSet::loadStatusChanged(Esri::ArcGISRuntime::LoadStatus loadStatus)

    Signal emitted when the load status changes for this object.

    See also Loadable.

    QStringList EncExchangeSet::paths() const

    Returns an QStringList of the paths of the ENC exchange set.

    An ENC exchange set can be loaded with the path to a single exchange set and zero or more update exchange sets. If an exchange set which only contains updates is loaded, the corresponding exchange set with the base cells must be loaded simultaneously.

    QString EncExchangeSet::readme() const

    Gets the Readme.txt file path of the ENC exchange set.

    [override virtual] void EncExchangeSet::retryLoad()

    Reimplements: Loadable::retryLoad().

    Loads or retries loading metadata for the object asynchronously.

    Will retry loading the metadata if the object is failed to load. Will load the object if it is not loaded. Will not retry to load the object if the object is loaded.

    See Loadable.

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