Spec-Zone.ru › Qt 5.15

Тип QML url

Тип url относится к идентификатору ресурса (например, имени файла). Он может быть абсолютным, например, "http://qt-project.org", или относительным, например, "pics/logo.png". Относительный URL разрешается относительно URL содержащего компонента.

Например, следующее присваивает допустимый URL свойству Image::source, тип которого url:

Image { source: "pics/logo.png" }

При интеграции с C++, обратите внимание, что любое значение QUrl, переданное в QML из C++, автоматически преобразуется в значение url, и наоборот.

Использование типа url

Когда относительный URL записывается в свойство типа url , он преобразуется в объект URL, поэтому сравнение значения URL со значением входной строки завершится неудачей. Вместо этого преобразуйте строку в URL, используя Qt.resolvedUrl() для целей сравнения, и используйте toString() для получения содержимого URL:

Image {
    source: "pics/logo.png"

    Component.onCompleted: {
        // This prints 'false'. Although "pics/logo.png" was the input string,
        // it's been converted from a string to a URL, so these two are not the same.
        console.log(source == "pics/logo.png")

        // This prints 'true' as Qt.resovledUrl() converts the string into a
        // URL with the correctly resolved path
        console.log(source == Qt.resolvedUrl("pics/logo.png"))

        // This prints the absolute path, e.g. "file:///path/to/pics/logo.png"
        console.log(source.toString())
    }
}

Примечание: При работе с файлами, хранящимися с помощью системы ресурсов Qt из QML, вы должны использовать "qrc:///" вместо ":/", так как QML требует пути URL. Относительные URL, разрешенные внутри этого файла, будут использовать тот же протокол.

Кроме того, URL могут содержать закодированные символы, используя схему «кодирования процентов», указанную в RFC 3986. Эти символы сохраняются в свойствах типа url, чтобы код QML мог создавать точные значения URL. Исключением из этого правила является предварительное декодирование символов разделителей каталогов ('/') — эти символы декодируются, чтобы URL мог быть правильно классифицирован.

Например, локальный файл, содержащий символ '#', который обычно интерпретируется как начало элемента фрагмента URL, можно получить, закодировав символы имени файла:

Image { source: encodeURIComponent("/tmp/test#1.png") }

Этот базовый тип предоставляется языком QML.

См. также Основные типы QML.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-url.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API