Тип 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)

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

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

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

Самый простой способ настроить всплывающие подсказки для элементов управления — указать 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)
    }
}

См. также Настройка всплывающей подсказки и Элементы управления 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 (в миллисекундах). Метод может быть присоединен к любому элементу.

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