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:
- Add ENC exchange set: Display nautical charts per the ENC specification.
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.
[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.
- loadStatus - The LoadStatus.
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.