Skip to content

Class IosPlatformUtilities

ClassList > IosPlatformUtilities

Inherits the following classes: PlatformUtilities

Public Types inherited from PlatformUtilities

See PlatformUtilities

Type Name
enum Capability
enum FileType

Public Properties inherited from PlatformUtilities

See PlatformUtilities

Type Name
property PlatformUtilities::Capabilities capabilities

Public Signals inherited from PlatformUtilities

See PlatformUtilities

Type Name
signal void resourceCanceled (const QString & message)
Emitted when a resource has been opened.
signal void resourceOpened (const QString & path)
Emitted when a resource has been opened.
signal void resourceReceived (const QString & path)
Emitted when a resource has been received.

Public Functions

Type Name
IosPlatformUtilities ()
virtual void afterUpdate () override
virtual QStringList appDataDirs () override const
virtual QString applicationDirectory () override const
virtual PlatformUtilities::Capabilities capabilities () override const
virtual Qt::PermissionStatus checkCameraPermission () override const
virtual Qt::PermissionStatus checkMicrophonePermission () override const
virtual ResourceSource * getCameraPicture (const QString & prefix, const QString & pictureFilePath, const QString & suffix, QObject * parent=nullptr) override
virtual ResourceSource * getCameraVideo (const QString & prefix, const QString & videoFilePath, const QString & suffix, QObject * parent=nullptr) override
virtual ResourceSource * getGalleryPicture (const QString & prefix, const QString & pictureFilePath, QObject * parent=nullptr) override
virtual ResourceSource * getGalleryVideo (const QString & prefix, const QString & videoFilePath, QObject * parent=nullptr) override
virtual bool isSystemDarkTheme () override const
virtual ViewStatus * open (const QString & uri, bool editing=false, QObject * parent=nullptr) override
virtual ProjectSource * openProject (QObject * parent=nullptr) override
virtual void requestCameraPermission (std::function< void(Qt::PermissionStatus)> func) override
virtual void requestMicrophonePermission (std::function< void(Qt::PermissionStatus)> func) override
virtual QStringList rootDirectories () override const
virtual void setScreenLockPermission (const bool allowLock) override
virtual double systemFontPointSize () override const
virtual QString systemSharedDataLocation () override const

Public Functions inherited from PlatformUtilities

See PlatformUtilities

Type Name
virtual QStringList additionalApplicationDirectories () const
virtual Q_INVOKABLE QStringList appDataDirs () const
virtual Q_INVOKABLE QString applicationDirectory () const
Q_INVOKABLE QStringList availableGrids () const
virtual PlatformUtilities::Capabilities capabilities () const
virtual Qt::PermissionStatus checkCameraPermission () const
virtual Q_DECL_DEPRECATED virtual Q_INVOKABLE bool checkCameraPermissions () const
virtual Qt::PermissionStatus checkMicrophonePermission () const
virtual Q_DECL_DEPRECATED virtual Q_INVOKABLE bool checkMicrophonePermissions () const
virtual Q_DECL_DEPRECATED virtual Q_INVOKABLE bool checkPositioningPermissions () const
virtual Q_INVOKABLE void copyTextToClipboard (const QString & string) const
Q_INVOKABLE bool createDir (const QString & path, const QString & dirname) const
virtual Q_INVOKABLE void dimBrightness ()
virtual void executeQfAction () const
virtual Q_INVOKABLE void exportDatasetTo (const QString & path) const
Exports a dataset path to a user-specified location.
virtual Q_INVOKABLE void exportFolderTo (const QString & path) const
Exports a folder path to a user-specified location.
virtual Q_INVOKABLE ResourceSource * getCameraPicture (const QString & prefix, const QString & pictureFilePath, const QString & suffix, QObject * parent=nullptr)
virtual Q_INVOKABLE ResourceSource * getCameraVideo (const QString & prefix, const QString & videoFilePath, const QString & suffix, QObject * parent=nullptr)
virtual Q_INVOKABLE ResourceSource * getFile (const QString & prefix, const QString & filePath, FileType fileType=AllFiles, QObject * parent=nullptr)
virtual Q_INVOKABLE ResourceSource * getGalleryPicture (const QString & prefix, const QString & pictureFilePath, QObject * parent=nullptr)
virtual Q_INVOKABLE ResourceSource * getGalleryVideo (const QString & prefix, const QString & videoFilePath, QObject * parent=nullptr)
virtual Q_INVOKABLE QString getTextFromClipboard () const
virtual bool hasQfAction () const
virtual bool hasQgsProject () const
virtual Q_INVOKABLE void importDatasets () const
Requests and imports one or more datasets into QField's application directory action.
virtual Q_INVOKABLE void importProjectArchive () const
Requests and imports a project archive into QField's application directory action.
virtual Q_INVOKABLE void importProjectFolder () const
Requests and imports a project folder into QField's application directory action.
void initSystem ()
virtual Q_INVOKABLE bool isSystemDarkTheme () const
virtual void loadQgsProject () const
virtual Q_INVOKABLE ViewStatus * open (const QString & uri, bool editing=false, QObject * parent=nullptr)
virtual Q_INVOKABLE ProjectSource * openProject (QObject * parent=nullptr)
virtual Q_INVOKABLE void removeDataset (const QString & path) const
Removes a given dataset path .
virtual Q_INVOKABLE void removeFolder (const QString & path) const
Removes a given folder path .
Q_INVOKABLE bool renameFile (const QString & oldFilePath, const QString & newFilePath, bool overwrite=true) const
virtual void requestBackgroundPositioningPermissions ()
virtual void requestCameraPermission (std::function< void(Qt::PermissionStatus)> func)
virtual void requestMicrophonePermission (std::function< void(Qt::PermissionStatus)> func)
virtual Q_INVOKABLE void requestStoragePermission () const
virtual Q_INVOKABLE void restoreBrightness ()
Q_INVOKABLE bool rmFile (const QString & filename) const
virtual QStringList rootDirectories () const
virtual Q_INVOKABLE void sendCompressedFolderTo (const QString & path) const
Compresses a folder path and sends it via the platform native API.
virtual Q_INVOKABLE void sendDatasetTo (const QString & path) const
Sends a dataset path via the platform native API.
virtual Q_INVOKABLE void setHandleVolumeKeys (const bool handle)
virtual Q_INVOKABLE void setScreenLockPermission (const bool allowLock)
virtual QString startPositioningService () const
virtual void stopPositioningService () const
virtual Q_INVOKABLE double systemFontPointSize () const
virtual QString systemLocalDataLocation (const QString & subDir=QString()) const
virtual QString systemSharedDataLocation () const
virtual Q_INVOKABLE void updateProjectFromArchive (const QString & projectPath) const
virtual Q_INVOKABLE void uploadPendingAttachments (QFieldCloudConnection * connection) const
virtual Q_INVOKABLE void vibrate (int milliseconds) const
virtual ~PlatformUtilities ()

Public Static Functions inherited from PlatformUtilities

See PlatformUtilities

Type Name
PlatformUtilities * instance ()

Public Functions Documentation

function IosPlatformUtilities

IosPlatformUtilities::IosPlatformUtilities ()

function afterUpdate

virtual void IosPlatformUtilities::afterUpdate () override

This method can be used to implement platform specific initialization tasks to be performed after an app update. This is implemented for Android to extract app assets to location where it can be accessed via filesystem.

Implements PlatformUtilities::afterUpdate

function appDataDirs

virtual QStringList IosPlatformUtilities::appDataDirs () override const

Returns:

a list of data directories where user data is searched. User data are pg_service.conf, authentication config, grids, ...

Implements PlatformUtilities::appDataDirs

function applicationDirectory

virtual QString IosPlatformUtilities::applicationDirectory () override const

The main application directory within which projects and datasets can be imported.

Implements PlatformUtilities::applicationDirectory

function capabilities

virtual PlatformUtilities::Capabilities IosPlatformUtilities::capabilities () override const

Returns flags containing the supported capabilities of the platform.

Implements PlatformUtilities::capabilities

function checkCameraPermission

virtual Qt::PermissionStatus IosPlatformUtilities::checkCameraPermission () override const

Implements PlatformUtilities::checkCameraPermission

function checkMicrophonePermission

virtual Qt::PermissionStatus IosPlatformUtilities::checkMicrophonePermission () override const

Implements PlatformUtilities::checkMicrophonePermission

function getCameraPicture

virtual ResourceSource * IosPlatformUtilities::getCameraPicture (
    const QString & prefix,
    const QString & pictureFilePath,
    const QString & suffix,
    QObject * parent=nullptr
) override

Get a picture from camera and copy it to the requested prefix

Parameters:

  • prefix The project folder
  • pictureFilePath The path (including subfolders and name) of the file

Returns:

The name of the picture or null

Implements PlatformUtilities::getCameraPicture

function getCameraVideo

virtual ResourceSource * IosPlatformUtilities::getCameraVideo (
    const QString & prefix,
    const QString & videoFilePath,
    const QString & suffix,
    QObject * parent=nullptr
) override

Get a video from camera and copy it to the requested prefix

Parameters:

  • prefix The project folder
  • videoFilePath The path (including subfolders and name) of the file

Returns:

The name of the video or null

Implements PlatformUtilities::getCameraVideo

function getGalleryPicture

virtual ResourceSource * IosPlatformUtilities::getGalleryPicture (
    const QString & prefix,
    const QString & pictureFilePath,
    QObject * parent=nullptr
) override

Get a picture from gallery and copy it to the requested prefix

Parameters:

  • prefix The project folder
  • pictureFilePath The path (including subfolders and name) of the file

Returns:

The name of the picture or null

Implements PlatformUtilities::getGalleryPicture

function getGalleryVideo

virtual ResourceSource * IosPlatformUtilities::getGalleryVideo (
    const QString & prefix,
    const QString & videoFilePath,
    QObject * parent=nullptr
) override

Get a video from gallery and copy it to the requested prefix

Parameters:

  • prefix The project folder
  • videoFilePath The path (including subfolders and name) of the video

Returns:

The name of the video or null

Implements PlatformUtilities::getGalleryVideo

function isSystemDarkTheme

virtual bool IosPlatformUtilities::isSystemDarkTheme () override const

Returns TRUE is the system uses a dark theme.

Implements PlatformUtilities::isSystemDarkTheme

function open

virtual ViewStatus * IosPlatformUtilities::open (
    const QString & uri,
    bool editing=false,
    QObject * parent=nullptr
) override

Open the resource (file, image, ...) that is available under uri. The mimetype is detected to indicate the system how the file should be opened. An optional editing parameter can be set to true to indicate to supported systems the resource is expected to be edited.

Implements PlatformUtilities::open

function openProject

virtual ProjectSource * IosPlatformUtilities::openProject (
    QObject * parent=nullptr
) override

Indicates the system that we want to open a project. The system shall show a suitable user interface element (like a filebrowser) to let the user select a project. The call returns immediately and the returned ProjectSource will notify when the project has actually been chosen.

Implements PlatformUtilities::openProject

function requestCameraPermission

virtual void IosPlatformUtilities::requestCameraPermission (
    std::function< void(Qt::PermissionStatus)> func
) override

Implements PlatformUtilities::requestCameraPermission

function requestMicrophonePermission

virtual void IosPlatformUtilities::requestMicrophonePermission (
    std::function< void(Qt::PermissionStatus)> func
) override

Implements PlatformUtilities::requestMicrophonePermission

function rootDirectories

inline virtual QStringList IosPlatformUtilities::rootDirectories () override const

A list of root directories (e.g. root of an external storage) when system-wide access is available.

Implements PlatformUtilities::rootDirectories

function setScreenLockPermission

virtual void IosPlatformUtilities::setScreenLockPermission (
    const bool allowLock
) override

Sets whether the device screen is allowed to go in lock mode.

Parameters:

  • allowLock if set to FALSE, the screen will not be allowed to lock.

Implements PlatformUtilities::setScreenLockPermission

function systemFontPointSize

inline virtual double IosPlatformUtilities::systemFontPointSize () override const

Returns the default system font size.

Implements PlatformUtilities::systemFontPointSize

function systemSharedDataLocation

virtual QString IosPlatformUtilities::systemSharedDataLocation () override const

The path to share data location. Under this path, there should be the app specific directories qgis/ proj/ qfield/ ... Refers to /share or /usr/share on Linux. This path is assumed to be read only.

Implements PlatformUtilities::systemSharedDataLocation

The documentation for this class was generated from the following file src/core/platforms/ios/iosplatformutilities.h