Тип QML ToolTip

Предоставляет всплывающие подсказки для любого элемента управления. Подробнее...

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

Свойства

• delay : int
• text : строка
• timeout : int

Присоединённые свойства

• delay : int
• text : строка
• timeout : int
• toolTip : ToolTip
• visible : bool

Методы

• void hide()
• void show(text, int timeout)

Присоединённые методы

• void hide()
• void show(text, int timeout = -1)

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

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

Присоединённые всплывающие подсказки

Самый простой способ настроить всплывающие подсказки для элементов управления — указать text и видимость с помощью присоединённых свойств. Следующий пример демонстрирует этот подход:

Button {
    text: qsTr("Save")

    ToolTip.visible: down
    ToolTip.text: qsTr("Save the active project")
}

В стандартных ситуациях одновременно видна только одна всплывающая подсказка. Чтобы сохранить ресурсы, все элементы, использующие присоединённое свойство ToolTip, используют один и тот же визуальный экземпляр метки всплывающей подсказки. Несмотря на то, что визуальные элементы общие, text, timeout и delay хранятся индивидуально для каждого элемента, использующего соответствующее присоединённое свойство. Однако несколько элементов не могут сделать общую всплывающую подсказку видимой одновременно. Общая всплывающая подсказка отображается только для последнего элемента, который сделал её видимой. Положение общей всплывающей подсказки определяется фреймворком.

Задержка и таймаут

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

Например, на сенсорных экранах обычным шаблоном является отображение всплывающей подсказки в результате удерживания нажатия на кнопку. Следующий пример демонстрирует, как отложить отображение всплывающей подсказки до достижения интервала удерживания нажатия. В этом примере всплывающая подсказка скрывается сразу после отпускания кнопки.

Button {
    text: qsTr("Button")

    ToolTip.visible: pressed
    ToolTip.delay: Qt.styleHints.mousePressAndHoldInterval
    ToolTip.text: qsTr("This tool tip is shown after pressing and holding the button down.")
}

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

Button {
    text: qsTr("Button")
    hoverEnabled: true

    ToolTip.delay: 1000
    ToolTip.timeout: 5000
    ToolTip.visible: hovered
    ToolTip.text: qsTr("This tool tip is shown after hovering the button for a second.")
}

Пользовательские всплывающие подсказки

Если требуется более точный контроль над положением всплывающей подсказки или необходимо несколько одновременных экземпляров всплывающих подсказок, можно также создать локальные экземпляры всплывающих подсказок. Таким образом, можно настроить всплывающую подсказку, и доступен весь API Popup. Следующий пример представляет всплывающую подсказку, которая отображает значение ползунка при перетаскивании рукоятки.

Slider {
    id: slider
    value: 0.5

    ToolTip {
        parent: slider.handle
        visible: slider.pressed
        text: slider.value.toFixed(1)
    }
}

См. также Настройка всплывающей подсказки и Элементы управления всплывающими окнами.

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

delay : int

Это свойство хранит задержку (миллисекунды) после которой отображается всплывающая подсказка. Всплывающая подсказка с отрицательной задержкой отображается немедленно. Значение по умолчанию — 0.

См. также Задержка и таймаут.

text : строка

Это свойство хранит текст, отображаемый на всплывающей подсказке.

timeout : int

Это свойство хранит таймаут (миллисекунды) после которого всплывающая подсказка скрывается. Всплывающая подсказка с отрицательным таймаутом не скрывается автоматически. Значение по умолчанию — -1.

См. также Задержка и таймаут.

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

ToolTip.delay : int

Это присоединённое свойство хранит задержку (миллисекунды) общей всплывающей подсказки. Свойство можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки и Задержка и таймаут.

ToolTip.text : строка

Это присоединённое свойство хранит текст общей всплывающей подсказки. Свойство можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки.

ToolTip.timeout : int

Это присоединённое свойство хранит таймаут (миллисекунды) общей всплывающей подсказки. Свойство можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки и Задержка и таймаут.

ToolTip.toolTip : ToolTip

Это присоединённое свойство хранит экземпляр общей всплывающей подсказки. Свойство можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки.

ToolTip.visible : bool

Это присоединённое свойство хранит значение, указывающее, видна ли общая всплывающая подсказка. Свойство можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки.

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

void hide()

Этот метод скрывает всплывающую подсказку.

Этот метод был добавлен в QtQuick.Controls 2.5 (Qt 5.12).

void show(text, int timeout)

Этот метод отображает text в виде всплывающей подсказки, которая скроется через timeout (миллисекунды).

Этот метод был добавлен в QtQuick.Controls 2.5 (Qt 5.12).

Документация по присоединённым методам

void hide()

Этот присоединённый метод скрывает общую всплывающую подсказку. Метод можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки.

void show(text, int timeout = -1)

Этот присоединённый метод отображает общую всплывающую подсказку с text и timeout (миллисекунды). Метод можно присоединить к любому элементу.

См. также Присоединённые всплывающие подсказки.