Skip To Content ArcGIS for Developers Sign In Dashboard

EncExchangeSet Class


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

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

Public Functions

EncExchangeSet(const QStringList &paths, QObject *parent = nullptr)
QList<EncDataset *> datasets() const
QStringList paths() const
QString readme() const

Reimplemented Public Functions

virtual void cancelLoad()
virtual void load()
virtual Error loadError() const
virtual LoadStatus loadStatus() const
virtual void retryLoad()


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

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 10 static public members inherited from QObject
  • 9 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

An Electronic Navigation Chart (ENC) exchange set object.

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
EncExchangeSet* 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();

See also Loadable and EncLayer.

Member Function Documentation

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

Constructor that takes a list of paths with an optional parent.



[virtual] void EncExchangeSet::cancelLoad()

Reimplemented from Loadable::cancelLoad().

See Loadable.

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

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

Gets the ENC datasets available in 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(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.

[virtual] void EncExchangeSet::load()

Reimplemented from Loadable::load().

See Loadable.

[virtual] Error EncExchangeSet::loadError() const

Reimplemented from Loadable::loadError().

See Loadable.

[virtual] LoadStatus EncExchangeSet::loadStatus() const

Reimplemented from Loadable::loadStatus().

See Loadable.

[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

Gets the paths of the ENC exchange set.

Note: 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.

[virtual] void EncExchangeSet::retryLoad()

Reimplemented from Loadable::retryLoad().

See Loadable.

Feedback on this topic?