QML-тип URIOpener

Предоставляет QML API для открытия URI. Подробнее....

Строка импорта: import Sailfish.Silica 1.0

Список всех членов класса, включая унаследованные

Методы

void openUri(url uri, var onSuccessFunc, var onErrorFunc)
void openUriWith(url uri, var onSuccessFunc, var onErrorFunc)

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

Объект URIOpener позволяет открывать различные URI, например ссылки или файлы, с помощью одного из установленных на устройстве приложений. Это объект-синглтон. Тип URIOpener не может быть создан.

Метод openUri используется для открытия URI без диалога выбора приложения в случае, если имеется только один доступный обработчик или пользователь заранее установил обработчик по умолчанию для локальных файлов с определенным типом MIME.

import Sailfish.Silica 1.0

Page {
    Button {
        text: "Открыть изображение"
        onClicked: URIOpener.openUri(Qt.resolvedUrl("../assets/image.png"))
    }
}

Чтобы обработать результат вызова метода openUri, пользователь может передать методу два обратных вызова:

Первый — это обратный вызов без аргументов, который вызывается при успешном открытии URI.
Второй — обратный вызов, принимающий строку сообщения об ошибке, который вызывается при возникновении ошибки открытия URI.

import Sailfish.Silica 1.0

Page {
    Button {
        text: "Открыть изображение"
        onClicked: {
            URIOpener.openUri(
                Qt.resolvedUrl("../assets/image.png"),
                function() { console.log("Успех") },
                function(error) { console.log("Ошибка", error) }
            )
        }
    }
}

Метод openUriWith используется для открытия URI с обязательным отображением диалога выбора приложения или диалога ошибки.

import Sailfish.Silica 1.0

Page {
    Button {
        text: "Открыть изображение с помощью приложения"
        onClicked: URIOpener.openUri(Qt.resolvedUrl("../assets/image.png"))
    }
}

Чтобы обработать результат вызова метода openUriWith, пользователь может передать методу два обратных вызова:

Первый — это обратный вызов без аргументов, который вызывается при успешном открытии URI.
Второй — обратный вызов, принимающий строку сообщения об ошибке, который вызывается при возникновении ошибки открытия URI.

import Sailfish.Silica 1.0

Page {
    Button {
        text: "Открыть изображение с помощью приложения"
        onClicked: {
            URIOpener.openUriWith(
                Qt.resolvedUrl("../assets/image.png"),
                function() { console.log("Успех") },
                function(error) { console.log("Ошибка", error) }
            )
        }
    }
}

Примечание: если при открытии локального файла методом openUri или openUriWith отображается диалог выбора приложения, пользователю предоставляется выбор: использовать выбранное приложение один раз или установить выбранное приложение в качестве обработчика по умолчанию для файлов с тем же типом MIME.

Описание методов

void openUri(url uri, var onSuccessFunc, var onErrorFunc)

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

Обратный вызов onSuccessFunc без аргументов вызывается при успешном открытии uri.

Обратный вызов onErrorFunc, принимающий строку сообщения об ошибке, вызывается при неудачном открытии uri.

Примечание. Обратные вызовы onSuccessFunc и onErrorFunc могут быть опущены.

void openUriWith(url uri, var onSuccessFunc, var onErrorFunc)

Открывает uri с обязательным отображением диалога выбора приложения или диалога ошибки.

Обратный вызов onSuccessFunc без аргументов вызывается при успешном открытии uri.

Обратный вызов onErrorFunc, принимающий строку сообщения об ошибке, вызывается при неудачном открытии uri.

Примечание. Обратные вызовы onSuccessFunc и onErrorFunc могут быть опущены.