Spec-Zone.ru › Qt 5.11

Тип Qt QML

Предоставляет глобальный объект с полезными перечислениями и функциями из Qt. Подробнее...

Заявление об импорте: import QtQml 2.11
  • Список всех членов, включая унаследованные

Свойства

  • application : объект
  • inputMethod : объект
  • platform : объект
  • styleHints : объект

Методы

  • строка atob(данные)
  • binding(функция)
  • строка btoa(данные)
  • callLater(функция, аргумент1, аргумент2, ...)
  • callLater(функция)
  • цвет colorEqual(цвет lhs, строка rhs)
  • объект createComponent(url, режим, родитель)
  • объект createQmlObject(строка qml, объект родитель, строка путь_к_файлу)
  • цвет darker(цвет baseColor, вещественное фактор)
  • exit(целое retCode)
  • font(объект fontSpecifier)
  • список<строка> fontFamilies()
  • строка formatDate(дата дата, вариант формат)
  • строка formatDateTime(дата_время dateTime, вариант формат)
  • строка formatTime(время время, вариант формат)
  • цвет hsla(вещественное hue, вещественное saturation, вещественное lightness, вещественное alpha)
  • цвет hsva(вещественное hue, вещественное saturation, вещественное value, вещественное alpha)
  • объект include(строка url, jsobject callback)
  • логическое isQtObject(объект)
  • цвет lighter(цвет baseColor, вещественное factor)
  • locale(имя)
  • строка md5(данные)
  • matrix4x4(вещественное m11, вещественное m12, вещественное m13, вещественное m14, вещественное m21, вещественное m22, вещественное m23, вещественное m24, вещественное m31, вещественное m32, вещественное m33, вещественное m34, вещественное m41, вещественное m42, вещественное m43, вещественное m44)
  • логическое openUrlExternally(url target)
  • точка point(целое x, целое y)
  • строка qsTr(строка sourceText, строка disambiguation, целое n)
  • строка qsTrId(строка id, целое n)
  • строка qsTrIdNoOp(строка id)
  • строка qsTrNoOp(строка sourceText, строка disambiguation)
  • строка qsTranslate(строка context, строка sourceText, строка disambiguation, целое n)
  • строка qsTranslateNoOp(строка context, строка sourceText, строка disambiguation)
  • quaternion(вещественное scalar, вещественное x, вещественное y, вещественное z)
  • quit()
  • прямоугольник rect(целое x, целое y, целое width, целое height)
  • url resolvedUrl(url url)
  • цвет rgba(вещественное red, вещественное green, вещественное blue, вещественное alpha)
  • size(целое width, целое height)
  • цвет tint(цвет baseColor, цвет tintColor)
  • vector2d(вещественное x, вещественное y)
  • vector3d(вещественное x, вещественное y, вещественное z)
  • vector4d(вещественное x, вещественное y, вещественное z, вещественное w)

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

Объект Qt — это глобальный объект с полезными функциями, свойствами и перечислениями.

Он не является экземпляризуемым; чтобы использовать его, вызывайте члены глобального объекта Qt напрямую. Например:

import QtQuick 2.0

Text {
    color: Qt.rgba(1, 0, 0, 1)
    text: Qt.md5("hello, world")
}

Перечисления

Объект Qt содержит перечисления, доступные в пространстве имен Qt. Например, вы можете получить значения перечисления Qt::LeftButton и Qt::RightButton как Qt.LeftButton и Qt.RightButton.

Типы

Объект Qt также содержит вспомогательные функции для создания объектов определенных типов данных. Это в основном полезно при установке свойств элемента, когда свойство имеет один из следующих типов:

  • rect - используйте Qt.rect()
  • point - используйте Qt.point()
  • size - используйте Qt.size()

Если модуль QtQuick импортирован, для клиентов также доступны следующие вспомогательные функции для создания объектов определенных типов данных:

  • color - используйте Qt.rgba(), Qt.hsla(), Qt.darker(), Qt.lighter() или Qt.tint()
  • font - используйте Qt.font()
  • vector2d - используйте Qt.vector2d()
  • vector3d - используйте Qt.vector3d()
  • vector4d - используйте Qt.vector4d()
  • quaternion - используйте Qt.quaternion()
  • matrix4x4 - используйте Qt.matrix4x4()

Для этих типов также существуют конструкторы на основе строк. См. Основные типы QML для получения дополнительной информации.

Форматирование дат/времени

Объект Qt содержит несколько функций для форматирования значений QDateTime, QDate и QTime.

  • строка Qt.formatDateTime(дата_время дата, вариант формат)
  • строка Qt.formatDate(дата дата, вариант формат)
  • строка Qt.formatTime(время время, вариант формат)

Спецификация формата описана в Qt.formatDateTime.

Динамическое создание объектов

Следующие функции глобального объекта позволяют динамически создавать QML-элементы из файлов или строк. См. Динамическое создание QML-объектов из JavaScript для общего обзора их использования.

  • объект Qt.createComponent(url)
  • объект Qt.createQmlObject(строка qml, объект родитель, строка путь_к_файлу)

Другие функции

Следующие функции также доступны в объекте Qt.

  • Qt.quit()
  • Qt.md5(строка)
  • строка Qt.btoa(строка)
  • строка Qt.atob(строка)
  • объект Qt.binding(функция)
  • объект Qt.locale()
  • строка Qt.resolvedUrl(строка)
  • Qt.openUrlExternally(строка)
  • список<строка> Qt.fontFamilies()

Документация по свойствам

application : объект

Объект application предоставляет доступ к свойствам глобального состояния приложения, общим для многих QML-компонентов.

Его свойства:

application.active Устаревшее, используйте Qt.application.state == Qt.ApplicationActive вместо этого.
application.state Это свойство только для чтения, которое указывает текущее состояние приложения.

Возможные значения:

  • Qt.ApplicationActive - Приложение является верхним и фокусированным приложением, и пользователь может взаимодействовать с приложением.
  • Qt.ApplicationInactive - Приложение отображается или частично отображается, но не выбрано для отображения впереди, пользователь не может взаимодействовать с приложением. На настольных платформах это обычно означает, что пользователь активировал другое приложение. На мобильных платформах чаще этот статус возникает, когда ОС прерывает пользователя, например, входящими вызовами, SMS-сообщениями или диалогами. Обычно это временное состояние, в котором приложение приостанавливается. Пользователь может вернуть фокус вашему приложению, но чаще всего это первый признак того, что приложение будет приостановлено. Будучи в этом состоянии, рассмотрите возможность приостановки или остановки любой деятельности, которая не должна продолжаться, когда пользователь не может взаимодействовать с вашим приложением, например, видео, игры, анимации или датчики. Также следует избегать выполнения ресурсоёмких задач, которые могут замедлить приложение в фокусе.
  • Qt.ApplicationSuspended - Приложение приостановлено и не отображается пользователю. На мобильных платформах приложение обычно переходит в это состояние, когда пользователь возвращается на главный экран или переключается на другое приложение. В этом состоянии приложение должно обеспечить, чтобы пользователь воспринимал его как всегда активное и не потерял свой прогресс, сохранив все постоянные данные. Приложение должно прекратить все действия и быть готовым к остановке выполнения кода. При приостановке приложение может быть закрыто в любое время без дополнительных предупреждений (например, когда низкая память заставляет ОС очистить приостановленные приложения).
  • Qt.ApplicationHidden - Приложение скрыто и выполняется в фоновом режиме. Это нормальное состояние для приложений, которым необходимо выполнять фоновые задачи, например, воспроизведение музыки, в то время как пользователь взаимодействует с другими приложениями. При переходе в это состояние приложение должно освободить все графические ресурсы. Приложение Qt Quick обычно не должно обрабатывать это состояние на уровне QML. Вместо этого следует разгрузить весь пользовательский интерфейс и перезагрузить файлы QML всякий раз, когда приложение становится активным снова.
application.layoutDirection Это свойство только для чтения может быть использовано для запроса направления макета по умолчанию приложения. При запуске системы направление макета по умолчанию зависит от языка приложения. Свойство имеет значение Qt.RightToLeft в языковых наборах, где текст и графические элементы читаются справа налево, и Qt.LeftToRight в тех, где направление чтения слева направо. Вы можете привязать это свойство, чтобы настроить макеты вашего приложения для поддержки обоих направлений макета.

Возможные значения:

  • Qt.LeftToRight - Текстовые и графические элементы должны быть расположены слева направо.
  • Qt.RightToLeft - Текстовые и графические элементы должны быть расположены справа налево.
application.font Это свойство только для чтения содержит шрифт приложения по умолчанию, возвращаемый QGuiApplication::font().
application.arguments Это список строк аргументов, с которыми был запущен исполняемый файл.
application.name Это имя приложения, заданное в экземпляре QCoreApplication. Это свойство можно изменить, чтобы установить имя приложения.
application.displayName (с Qt 5.9) Это отображаемое имя приложения, заданное в экземпляре QGuiApplication. Это свойство можно изменить, чтобы установить отображаемое имя приложения.
application.version Это версия приложения, заданная в экземпляре QCoreApplication. Это свойство можно изменить, чтобы установить версию приложения.
application.organization Это имя организации, заданное в экземпляре QCoreApplication. Это свойство можно изменить, чтобы установить имя организации.
application.domain Это домен организации, заданный в экземпляре QCoreApplication. Это свойство можно изменить, чтобы установить домен организации.
application.supportsMultipleWindows Это свойство только для чтения, которое можно использовать для определения того, поддерживает ли платформа несколько окон. Например, некоторые встроенные платформы не поддерживают несколько окон.
application.screens Массив, содержащий описания всех подключённых экранов. Элементы массива — объекты с теми же свойствами, что и присоединённый объект Screen. На практике массив соответствует списку экранов, возвращаемому QGuiApplication::screens(). Кроме проверки свойств, таких как имя, ширина, высота и т. д., элементы массива также могут быть назначены свойству screen элементов Window, тем самым служа альтернативой методу QWindow::setScreen() на стороне C++. Это свойство было добавлено в Qt 5.9.

Объект также имеет один сигнал, aboutToQuit(), который идентичен QCoreApplication::aboutToQuit().

Следующий пример использует объект application для указания того, является ли приложение в данный момент активным:

import QtQuick 2.0

Rectangle {
    width: 300; height: 55
    color: Qt.application.active ? "white" : "lightgray"
    Text {
        text: "Application " + (Qt.application.active ? "active" : "inactive")
        opacity: Qt.application.active ? 1.0 : 0.5
        anchors.centerIn: parent
    }
}

Обратите внимание, что при использовании QML без QGuiApplication следующие свойства будут не определены:

  • application.active
  • application.state
  • application.layoutDirection
  • application.font

Это свойство было введено в Qt 5.1.

См. также Screen, Window и Window.screen.

inputMethod : object

Объект inputMethod предоставляет доступ к объекту QInputMethod приложения и всем его свойствам и слотам. Подробнее см. документацию QInputMethod.

Это свойство было введено в Qt 5.0.

platform : object

Объект platform предоставляет информацию об underlying платформе.

Его свойства:

platform.os Это свойство только для чтения содержит имя операционной системы.

Возможные значения:

  • "android" - Android
  • "ios" - iOS
  • "tvos" - tvOS
  • "linux" - Linux
  • "osx" - macOS
  • "qnx" - QNX (с Qt 5.9.3)
  • "unix" - Другие Unix-подобные ОС
  • "windows" - Windows
  • "winrt" - WinRT / UWP
platform.pluginName Это имя платформы, заданное в экземпляре QGuiApplication и возвращаемое QGuiApplication::platformName()

Это свойство было введено в Qt 5.1.

styleHints : object

Объект styleHints предоставляет специфичные для платформы подсказки и настройки стиля. См. документацию QStyleHints для получения дополнительной информации.

Примечание: Объект styleHints доступен только при использовании модуля Qt Quick.

Следующий пример использует объект styleHints для определения того, должен ли элемент получить фокус при нажатии мыши или отпускании сенсорного экрана:

import QtQuick 2.4

MouseArea {
    id: button

    onPressed: {
        if (!Qt.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
    onReleased: {
        if (Qt.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
}

Это свойство было введено в Qt 5.5.

Документация по методам

строка atob(данные)

ASCII в двоичный - эта функция декодирует строку данных, закодированную в base64, и возвращает её.

binding(функция)

Возвращает объект JavaScript, представляющий привязку свойства.

Функция имеет два основных случая использования: во-первых, чтобы применить привязку свойства императивно из кода JavaScript:

Item {
    property bool someCondition: true
    property int edgePosition

    Component.onCompleted: {
        if (someCondition == true) {
            // bind to the result of the binding expression passed to Qt.binding()
            edgePosition = Qt.binding(function() { return x + width })
        }
    }
}

и, во-вторых, чтобы применить привязку свойства при инициализации значений свойств динамически созданных объектов (с помощью Component.createObject() или Loader.setSource()).

Например, предположим, что существует компонент DynamicText:

import QtQuick 2.0

Text {
    id: textElement
    width: 200
    height: 200
    text: "Default text"
    property string dynamicText: "Dynamic text"
    onTextChanged: console.log(text)
}

выход из:

Item {
    id: root
    property string dynamicText: "Root text"

    Component.onCompleted: {
        var c = Qt.createComponent("DynamicText.qml")

        var obj1 = c.createObject(root, { 'text': Qt.binding(function() { return dynamicText + ' extra text' }) })
        root.dynamicText = "Modified root text"

        var obj2 = c.createObject(root, { 'text': Qt.binding(function() { return this.dynamicText + ' extra text' }) })
        obj2.dynamicText = "Modified dynamic text"
    }
}

и из:

Item {
    id: root
    property string dynamicText: "Root text"

    Loader {
        id: loaderOne
        onLoaded: root.dynamicText = "Modified root text"
    }

    Loader {
        id: loaderTwo
        onLoaded: item.dynamicText = "Modified dynamic text"
    }

    Component.onCompleted: {
        loaderOne.setSource("DynamicText.qml", { 'text': Qt.binding(function() { return dynamicText + ' extra text' }) })
        loaderTwo.setSource("DynamicText.qml", { 'text': Qt.binding(function() { return this.dynamicText + ' extra text' }) })
    }
}

должен быть:

Root text extra text
Modified root text extra text
Dynamic text extra text
Modified dynamic text extra text

Эта функция не может использоваться в объявлениях привязок свойств (см. документацию по объявлениям привязки и присвоениям привязки), за исключением случаев, когда результат хранится в массиве, привязанном к свойству var.

Item {
    width: 50
    property var storedBindings: [ Qt.binding(function() { return x + width }) ] // stored
    property int a: Qt.binding(function() { return x + width }) // error!
    property int b

    Component.onCompleted: {
        b = storedBindings[0] // causes binding assignment
    }
}

Примечание: В Qt Quick 1 все присвоения функций рассматривались как присвоения привязки. Функция Qt.binding() нова для Qt Quick 2.

Этот метод был введён в Qt 5.0.

строка btoa(данные)

Двоичный в ASCII - эта функция возвращает base64-кодировку data.

callLater(функция, аргумент1, аргумент2, ...)

callLater(функция)

цвет colorEqual(цвет lhs, строка rhs)

Возвращает true, если оба lhs и rhs дают одинаковые цветовые значения. Оба аргумента могут быть либо цветовыми значениями, либо строковыми значениями. Если предоставлено строковое значение, оно должно быть преобразуемо в цвет, как описано для базового типа цвет.

объект createComponent(url, mode, parent)

Возвращает объект Component, созданный с помощью QML-файла по указанному url, или null если была передана пустая строка.

Свойство Component::status возвращаемого компонента указывает, был ли компонент успешно создан. Если статус равен Component.Error, см. Component::errorString() для описания ошибки.

Если необязательный параметр mode установлен в Component.Asynchronous, компонент будет загружен в фоновом потоке. Свойство Component::status будет Component.Loading во время загрузки. Статус изменится на Component.Ready при успешной загрузке компонента или на Component.Error при неудачной загрузке. Если этот параметр опущен, он по умолчанию равен Component.PreferSynchronous.

Если mode установлен в Component.PreferSynchronous, Qt попытается загрузить компонент синхронно, но может в конечном итоге загрузить его асинхронно, если это необходимо. Сценарии, которые могут привести к асинхронной загрузке, включают, но не ограничиваются ими:

  • URL ссылается на сетевой ресурс
  • Компонент создается в результате загрузки другого компонента асинхронно

Если необязательный параметр parent задан, он должен ссылаться на объект, который станет родителем созданного объекта Component. Если параметр mode не был передан, он может быть вторым аргументом.

Вызовите Component.createObject() для возвращаемого компонента, чтобы создать экземпляр объекта компонента.

Например:

import QtQuick 2.0

Item {
    id: container
    width: 300; height: 300

    function loadButton() {
        var component = Qt.createComponent("Button.qml");
        if (component.status == Component.Ready) {
            var button = component.createObject(container);
            button.color = "red";
        }
    }

    Component.onCompleted: loadButton()
}

См. Динамическое создание QML-объектов из JavaScript для получения дополнительной информации об использовании этой функции.

Для создания QML-объекта из произвольной строки QML (вместо файла) используйте Qt.createQmlObject().

объект createQmlObject(строка qml, объект parent, строка filepath)

Возвращает новый объект, созданный из заданной строки qml, который будет иметь указанный parent, или null если при создании объекта произошла ошибка.

Если задан параметр filepath, он будет использован для отчетов об ошибках для созданного объекта.

Пример (где parentItem — идентификатор существующего QML-элемента):

var newObject = Qt.createQmlObject('import QtQuick 2.0; Rectangle {color: "red"; width: 20; height: 20}',
                                   parentItem,
                                   "dynamicSnippet1");

В случае ошибки выбрасывается объект ошибки Qt Script. У этого объекта есть дополнительное свойство qmlErrors, которое представляет собой массив обнаруженных ошибок. Каждый объект в этом массиве имеет члены lineNumber, columnNumber, fileName и message. Например, если в приведенном выше фрагменте было неправильно написано color как 'colro', то массив будет содержать объект следующего вида: { "lineNumber" : 1, "columnNumber" : 32, "fileName" : "dynamicSnippet1", "message" : "Нельзя присвоить несуществующему свойству \"colro\" " }.

Обратите внимание, что эта функция возвращает результат немедленно и поэтому может не работать, если строка qml загружает новые компоненты (то есть внешние QML-файлы, которые еще не были загружены). Если это так, рассмотрите возможность использования Qt.createComponent() вместо этого.

См. Динамическое создание QML-объектов из JavaScript для получения дополнительной информации об использовании этой функции.

цвет darker(цвет baseColor, вещественный factor)

Возвращает цвет, более тёмный, чем baseColor на величину factor.

Если параметр factor больше 1.0, эта функция возвращает более тёмный цвет. Установка параметра factor в 3.0 возвращает цвет с яркостью в одну треть. Если параметр factor меньше 1.0, возвращаемый цвет будет светлее, но для этой цели рекомендуется использовать функцию Qt.lighter(). Если параметр factor равен 0 или отрицателен, возвращаемое значение не определено.

Функция преобразует текущий цвет RGB в HSV, делит компонент значения (V) на factor и преобразует цвет обратно в RGB.

Если параметр factor не задан, возвращается цвет, на 50% темнее, чем baseColor (фактор 2.0).

exit(целое retCode)

Эта функция вызывает испускание сигнала QQmlEngine::exit(int). Внутри qmlscene это приводит к завершению приложения-запускателя с указанным кодом возврата. Для завершения цикла событий с указанным кодом возврата при вызове этого метода приложение на C++ может подключить сигнал QQmlEngine::exit(int) к слоту QCoreApplication::exit(int).

См. также quit().

font(объект fontSpecifier)

Возвращает шрифт с свойствами, указанными в объекте fontSpecifier или ближайшим соответствующим шрифтом. Объект fontSpecifier должен содержать пары "ключ-значение", где допустимые ключи — имена подсвойств типа шрифта, а значения — допустимые значения для каждого подсвойства. Недопустимые ключи будут проигнорированы.

список<строка> fontFamilies()

Возвращает список доступных в приложении семейств шрифтов.

строка formatDate(дата date, значение format)

Возвращает строковое представление date, необязательно отформатированное в соответствии с format.

Параметр date может быть объектом JavaScript Date, свойством date, значением QDate или QDateTime.

Параметр format может быть любым из возможных значений формата, как описано для Qt.formatDateTime().

Если format не указан, date форматируется с использованием Qt.DefaultLocaleShortDate.

См. также Локаль.

строка formatDateTime(дата-время dateTime, значение format)

Возвращает строковое представление datetime, необязательно отформатированное в соответствии с format.

Параметр dateTime может быть объектом JavaScript Date, свойством date, значением QDate, QTime или QDateTime.

Если format не задан, dateTime форматируется с использованием Qt.DefaultLocaleShortDate. В противном случае format должен быть:

  • Одним из значений перечисления Qt::DateFormat, например, Qt.DefaultLocaleShortDate или Qt.ISODate
  • Строкой, которая определяет формат возвращаемой строки, как подробно описано ниже.

Если format определяет строку формата, он должен использовать следующие выражения для указания даты:

Выражение Вывод
d день как число без ведущего нуля (1-31)
dd день как число с ведущим нулем (01-31)
ddd сокращённое локальное название дня (например, 'Пн' до 'Вс'). Использует QDate::shortDayName().
dddd полное локальное название дня (например, 'Понедельник' до 'Qt::Sunday'). Использует QDate::longDayName().
M месяц как число без ведущего нуля (1-12)
MM месяц как число с ведущим нулем (01-12)
MMM сокращённое локальное название месяца (например, 'Янв' до 'Дек'). Использует QDate::shortMonthName().
MMMM полное локальное название месяца (например, 'Январь' до 'Декабрь'). Использует QDate::longMonthName().
yy год как число с двумя цифрами (00-99)
yyyy год как число с четырьмя цифрами

Кроме того, следующие выражения можно использовать для указания времени:

Выражение Вывод
h час без ведущего нуля (0-23 или 1-12, если отображаются AM/PM)
hh час с ведущим нулем (00-23 или 01-12, если отображаются AM/PM)
m минута без ведущего нуля (0-59)
mm минута с ведущим нулем (00-59)
s секунда без ведущего нуля (0-59)
ss секунда с ведущим нулем (00-59)
z миллисекунды без ведущих нулей (0-999)
zzz миллисекунды с ведущими нулями (000-999)
AP использовать AM/PM. AP будет заменено на "AM" или "PM"
ap использовать am/pm. ap будет заменено на "am" или "pm"
t включить индикатор часового пояса.

Все остальные символы входных данных будут проигнорированы. Любая последовательность символов, заключенная в одинарные кавычки, будет рассматриваться как текст и не будет использоваться как выражение. Две последовательные одинарные кавычки ("''") заменяются одной одинарной кавычкой в выводе.

Например, если было указано следующее значение даты/времени:

// 21 May 2001 14:13:09
var dateTime = new Date(2001, 5, 21, 14, 13, 09)

Это значение dateTime можно передать в Qt.formatDateTime(), Qt.formatDate() или Qt.formatTime() вместе со значениями формата ниже, чтобы получить следующие результаты:

Формат Результат
"dd.MM.yyyy" 21.05.2001
"ddd MMMM d yy" Вт Май 21 01
"hh:mm:ss.zzz" 14:13:09.042
"h:m:s ap" 2:13:9 пп

См. также Региональные настройки.

строка formatTime(datetime время, переменная формат)

Возвращает строковое представление time, необязательно отформатированное в соответствии с format.

Параметр время может быть объектом JavaScript Date , значением QTime или QDateTime. Параметр формат может быть любым из возможных значений формата, как описано для Qt.formatDateTime().

Если формат не указан, время форматируется с использованием Qt.DefaultLocaleShortDate.

См. также Региональные настройки.

цвет hsla(вещественный оттенок, вещественный насыщенность, вещественный светлота, вещественный альфа)

Возвращает цвет с указанными hue, saturation, lightness и alpha компонентами. Все компоненты должны быть в диапазоне от 0 до 1 включительно.

цвет hsva(вещественный оттенок, вещественный насыщенность, вещественный значение, вещественный альфа)

Возвращает цвет с указанными hue, saturation, value и alpha компонентами. Все компоненты должны быть в диапазоне от 0 до 1 включительно.

Этот метод был представлен в Qt 5.5.

объект include(строка url, jsobject callback)

Включает другой файл JavaScript. Этот метод может использоваться только изнутри файлов JavaScript, а не обычных файлов QML.

Импортирует все функции из url в пространство имен текущего скрипта.

Qt.include() возвращает объект, описывающий статус операции. Объект имеет единственное свойство, status, которое устанавливается в одно из следующих значений:

Символ Значение Описание
result.OK 0 Включение выполнено успешно.
result.LOADING 1 Данные загружаются из сети.
result.NETWORK_ERROR 2 Произошла ошибка сети при получении url.
result.EXCEPTION 3 Произошло исключение JavaScript при выполнении включённого кода. В этом случае будет установлено дополнительное свойство exception.

Свойство status будет обновляться по мере выполнения операции.

Если предоставлен, callback вызывается по завершении операции. Callback получает тот же объект, что и возвращается вызовом Qt.include().

булево isQtObject(объект)

Возвращает true, если object является допустимой ссылкой на объект Qt или QML, в противном случае false.

цвет lighter(цвет базовыйЦвет, вещественный множитель)

Возвращает цвет, более светлый, чем baseColor на указанный factor.

Если множитель больше 1.0, эта функция возвращает более светлый цвет. Установка множителя в 1.5 возвращает цвет, который на 50% светлее. Если множитель меньше 1.0, возвращаемый цвет темнее, но для этой цели рекомендуется использовать функцию Qt.darker(). Если множитель равен 0 или отрицателен, возвращаемое значение не определено.

Функция преобразует текущий цвет RGB в HSV, умножает компонент значения (V) на множитель и преобразует цвет обратно в RGB.

Если factor не указан, возвращает цвет, на 50% светлее, чем baseColor (множитель 1.5).

locale(имя)

Возвращает JS-объект, представляющий региональные настройки с указанным именем, имеющим формат "язык[_территория][.кодировка][@модификатор]" или "C", где:

  • язык — это двухбуквенный код языка, нижним регистром, ISO 639,
  • территория — это двухбуквенный код страны, верхним регистром, ISO 3166,
  • и кодировка и модификатор игнорируются.

Если строка нарушает формат региональных настроек или язык не является допустимым кодом ISO 369, используется региональные настройки "C". Если страна не указана или не является допустимым кодом ISO 3166, выбирается наиболее подходящая страна для указанного языка.

См. также Региональные настройки.

строка md5(данные)

Возвращает шестнадцатеричную строку хэш-суммы md5 data.

matrix4x4(вещественный m11, вещественный m12, вещественный m13, вещественный m14, вещественный m21, вещественный m22, вещественный m23, вещественный m24, вещественный m31, вещественный m32, вещественный m33, вещественный m34, вещественный m41, вещественный m42, вещественный m43, вещественный m44)

Возвращает Matrix4x4 с указанными значениями. В качестве альтернативы функция может быть вызвана с единственным аргументом, где этот аргумент является массивом JavaScript, содержащим шестнадцать значений матрицы. Наконец, функция может быть вызвана без аргументов, и в результате будет получена единичная матрица.

булево openUrlExternally(url цель)

Пытается открыть указанный target URL в внешнем приложении, в зависимости от настроек рабочего стола пользователя. Возвращает true, если это удалось, и false в противном случае.

Предупреждение: Возвращаемое значение true указывает на то, что приложение успешно запросило операционную систему открыть URL-адрес во внешнем приложении. Внешнее приложение всё равно может завершиться неудачей или не открыть запрашиваемый URL-адрес. Этот результат не будет сообщён приложению.

точка point(целое x, целое y)

Возвращает точку с указанными x и y координатами.

строка qsTr(строка исходныйТекст, строка различия, целое n)

Возвращает переведённую версию исходныйТекст, необязательно на основе строки различия и значения n для строк, содержащих множественные формы; в противном случае возвращает сам исходныйТекст, если нет соответствующей переведённой строки.

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

Пример:

Text { text: qsTr("hello") }

См. также Международная и локальная локализация Qt Quick.

строка qsTrId(строка id, целое n)

Возвращает переведённую строку, идентифицированную id. Если подходящей строки не найдено, возвращается сам id. Этого не должно происходить в нормальных условиях.

Если n >= 0, все вхождения %n в результирующей строке заменяются десятичным представлением n. Кроме того, в зависимости от значения n, текст перевода может меняться.

Пример:

Text { text: qsTrId("hello_id") }

Можно указать шаблон исходной строки, например:

//% <string>

или

\begincomment% <string> \endcomment

Пример:

Text {
    //% "hello"
    text: qsTrId("hello_id")
}

Создание двоичных файлов перевода (QM), пригодных для использования с этой функцией, требует передачи параметра -idbased в инструмент lrelease.

См. также QT_TRID_NOOP() и Международная и локальная локализация Qt Quick.

строка qsTrIdNoOp(строка id)

Помечает id для динамического перевода.

Возвращает id.

END_OF_DOCUMENT_MARKER

QT_TRID_NOOP используется совместно с функцией динамического перевода qsTrId(). Она отмечает строку, требующую перевода (чтобы она могла быть идентифицирована lupdate), но фактический перевод выполняется функцией qsTrId().

Пример:

Item {
    property string greetingId: QT_TRID_NOOP("hello_id")

    Text { text: qsTrId(greetingId) }
}

См. также qsTrId() и Международные и локальные настройки с Qt Quick.

строка qsTrNoOp(строка sourceText, строка disambiguation)

Отмечает sourceText для динамического перевода; т.е. сохранённый sourceText не будет изменён.

Если один и тот же sourceText используется в разных ролях в одном контексте перевода, для disambiguation можно передать дополнительную строку идентификации.

Возвращает sourceText.

QT_TR_NOOP используется совместно с функциями динамического перевода qsTr() и qsTranslate(). Она отмечает строку, требующую перевода (чтобы она могла быть идентифицирована lupdate), но фактический перевод выполняется динамическими функциями.

Пример:

Item {
    property string greeting: QT_TR_NOOP("hello")

    Text { text: qsTr(greeting) }
}

См. также Международные и локальные настройки с Qt Quick.

строка qsTranslate(строка context, строка sourceText, строка disambiguation, целое n)

Возвращает переведённую версию sourceText в заданном context, необязательно на основе строки disambiguation и значения n для строк, содержащих множественное число; в противном случае возвращает sourceText, если соответствующая переведённая строка недоступна.

Если один и тот же sourceText используется в разных ролях в одном контексте перевода context, для disambiguation можно передать дополнительную строку идентификации.

Пример:

Text { text: qsTranslate("CustomContext", "hello") }

См. также Международные и локальные настройки с Qt Quick.

строка qsTranslateNoOp(строка context, строка sourceText, строка disambiguation)

Отмечает sourceText для динамического перевода в данном context; т.е. сохранённый sourceText не будет изменён.

Если один и тот же sourceText используется в разных ролях в одном контексте перевода, для disambiguation можно передать дополнительную строку идентификации.

Возвращает sourceText.

QT_TRANSLATE_NOOP используется совместно с функциями динамического перевода qsTr() и qsTranslate(). Она отмечает строку, требующую перевода (чтобы она могла быть идентифицирована lupdate), но фактический перевод выполняется динамическими функциями.

Пример:

Item {
    property string greeting: QT_TRANSLATE_NOOP("CustomContext", "hello")

    Text { text: qsTranslate("CustomContext", greeting) }
}

См. также Международные и локальные настройки с Qt Quick.

quaternion(вещественное scalar, вещественное x, вещественное y, вещественное z)

Возвращает Кватернион со специфицированными scalar, x, y, и z.

quit()

Эта функция вызывает эмиссию сигнала QQmlEngine::quit(). Внутри Prototyping with qmlscene это приводит к завершению приложения-запускателя; для завершения приложения C++ при вызове этого метода подключите сигнал QQmlEngine::quit() к слоту QCoreApplication::quit().

См. также exit().

прямоугольник rect(целое x, целое y, целое width, целое height)

Возвращает rect с верхним левым углом в x, y и указанными width и height.

Возвращаемый объект имеет x, y, width и height атрибуты со значениями, заданными в списке параметров.

url resolvedUrl(url url)

Возвращает url, разрешённый относительно URL вызывающего элемента.

цвет rgba(вещественное red, вещественное green, вещественное blue, вещественное alpha)

Возвращает цвет с указанными red, green, blue и alpha компонентами. Все компоненты должны быть в диапазоне от 0 до 1 включительно.

size(целое width, целое height)

Возвращает Size с указанными width и height.

цвет tint(цвет baseColor, цвет tintColor)

Эта функция позволяет тонировать один цвет другим.

Цвет тонирования обычно должен быть в основном прозрачным, иначе вы не сможете увидеть основной цвет. Приведённый ниже пример обеспечивает легкую красную тонировку, так как цвет тонирования — чистый красный, который имеет только 1/16 непрозрачности.

Item {
    Rectangle {
        x: 0; width: 80; height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Qt.tint("lightsteelblue", "#10FF0000")
    }
}

Тонирование наиболее полезно, когда необходимо передать тонкие изменения из-за какого-либо события; тогда вы можете использовать тонирование для более эффективной настройки видимого цвета.

vector2d(вещественное x, вещественное y)

Возвращает Vector2D с указанными x и y.

vector3d(вещественное x, вещественное y, вещественное z)

Возвращает Vector3D с указанными x, y и z.

vector4d(вещественное x, вещественное y, вещественное z, вещественное w)

Возвращает Vector4D с указанными x, y, z и w.

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

Spec-Zone.ru

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