Тип QML ToolTip

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

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

Свойства

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

Прикрепленные свойства

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

Методы

• void hide()
• void show(строка text, int timeout = -1)

Прикрепленные методы

• void hide()
• void show(строка text, int timeout = -1)

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

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

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

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

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)
    }
}

См. также Настройка ToolTip и Элементы управления Popup.

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

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 = -1)

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

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

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

void hide()

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

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

void show(строка text, int timeout = -1)

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

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