ToolTip QML Тип

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

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

Свойства

• delay : int
• text : string
• timeout : int

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

• delay : int
• text : string
• timeout : int
• toolTip : ToolTip
• visible : bool

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

• void hide()
• void show(string 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 : string

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

timeout : int

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

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

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

ToolTip.delay : int

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

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

ToolTip.text : string

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

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

ToolTip.timeout : int

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

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

ToolTip.toolTip : ToolTip

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

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

ToolTip.visible : bool

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

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

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

void hide()

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

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

void show(string text, int timeout = -1)

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

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