Пространство имён Hints

Переменные

const QString IgnoreHosts	Хосты, игнорируемые хинтом OpenURI.
const QString IgnoreSchemes	Схемы, игнорируемые хинтом OpenURI.
const QString PreferredHandler	ID приложения требуемого обработчика.
const QString ReadFiles	JSON-путь файлов для предоставления в режиме только для чтения.
const QString RefocusOnReturn	Должно ли возвращаться управление к вызывающей стороне.
const QString SuppressErrorDialog	Следует ли скрывать диалоговые окна ошибок.
const QString WriteFiles	JSON-путь файлов для предоставления в режиме чтения-записи.

Подробное описание

Хинты интента.

Хинты, доступные для передачи в IntentsInvoker::invoke(). Эти хинты влияют на поведение менеджера выполнения при обработке вызова интента, например на выбор приложения-обработчика и файлов, которые необходимо предоставить приложению-обработчику интента. Следует учитывать, что хинты не направляются обработчику интента (ему доступны исключительно параметры интента).

Описание переменных

IgnoreHosts

const QString RuntimeManager::Intents::Hints::IgnoreHosts

Хосты, игнорируемые хинтом OpenURI.

Этот хинт действителен только для интента Intents::OpenUri. Он содержит список хостов, которые будут игнорироваться при поиске обработчика интента: это приведёт к игнорированию всех правил desktop-файлов типа x-url-handler. Установка значения "all" приведёт к игнорированию всех правил для хостов.

IgnoreSchemes

const QString RuntimeManager::Intents::Hints::IgnoreSchemes

Схемы, игнорируемые хинтом OpenURI.

Этот хинт действителен только для интента Intents::OpenUri. Он содержит список схем, которые будут игнорироваться при поиске обработчика интента: это приведёт к игнорированию всех правил desktop-файлов типа x-scheme-handler. Установка значения "all" приведёт к игнорированию всех правил для схем.

PreferredHandler

const QString RuntimeManager::Intents::Hints::PreferredHandler

ID приложения требуемого обработчика.

Примечание. Этот хинт будет учтён только если оба приложения принадлежат одной организации.

ReadFiles

const QString RuntimeManager::Intents::Hints::ReadFiles

JSON-путь файлов для предоставления в режиме только для чтения.

Данный механизм предоставляет файлы обработчику интента в режиме "только чтение": данный хинт должен представлять собой перечень строк, каждая из которых является JSON-путём к элементам словаря параметров. Данный словарь содержит адреса файлов, необходимых для целевого приложения. К примеру, если ключ inputFile в словаре параметров хранит путь к файлу, требующему доступ от обработчика интента в режиме "только чтение", данный хинт следует установить в ["inputFile"].

Примечание. Этот хинт действителен только для пользовательских интентов.

RefocusOnReturn

const QString RuntimeManager::Intents::Hints::RefocusOnReturn

Должно ли возвращаться управление к вызывающей стороне.

Логическое значение, указывающее, следует ли возвращать фокус вызывающей стороне после завершения задачи обработчиком интента.

Примечание. Этот хинт действителен только для пользовательских интентов.

SuppressErrorDialog

const QString RuntimeManager::Intents::Hints::SuppressErrorDialog

Следует ли скрывать диалоговые окна ошибок.

Если true, приложение будет уведомлять пользователя в случае возникновения ошибки (например, если не установлено подходящего обработчика). В противном случае система сама отобразит сообщение об ошибке при необходимости.

WriteFiles

const QString RuntimeManager::Intents::Hints::WriteFiles

JSON-путь файлов для предоставления в режиме чтения-записи.

Данный механизм применяется для предоставления файлов обработчику интента в режиме чтения и записи: данный хинт должен представлять собой перечень строк, каждая из которых является JSON-путём к элементам словаря параметров. Данный словарь содержит адреса файлов, необходимых для целевого приложения. К примеру, если ключ outputFile в словаре параметров хранит путь к файлу, требующему доступа обработчику интента в режиме чтения и записи, данный хинт следует установить в ["outputFile"].

Примечание. Этот хинт действителен только для пользовательских интентов.