Класс QToolTip

Класс QToolTip предоставляет всплывающие подсказки (шарики помощи) для любого виджета. Подробнее...

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

Статические публичные члены

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

Класс QToolTip предоставляет всплывающие подсказки (шарики помощи) для любого виджета.

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

Форматированный текст, отображаемый во всплывающей подсказке, неявно переносится на новую строку, если не указано иное с помощью <p style='white-space:pre'>.

Самый простой и распространенный способ установки подсказки виджета — вызов его функции QWidget::setToolTip().

Также можно отображать разные подсказки для разных областей виджета, используя QHelpEvent типа QEvent::ToolTip. Перехватывайте событие помощи в функции event() своего виджета и вызывайте QToolTip::showText() с текстом, который вы хотите отобразить. Пример Tooltips иллюстрирует эту технику.

Если вы вызываете QToolTip::hideText() или QToolTip::showText() с пустой строкой в результате события ToolTip, вы также должны вызвать ignore() для события, чтобы сигнализировать о том, что вы не хотите запускать никаких режимов, специфичных для всплывающих подсказок.

Обратите внимание, что если вы хотите отображать подсказки в представлении элементов, архитектура модели/представления предоставляет возможность установить подсказку элемента, например, функция QTableWidgetItem::setToolTip(). Однако, если вы хотите предоставить пользовательские подсказки в представлении элементов, вы должны перехватить событие помощи в функции QAbstractItemView::viewportEvent() и обработать его самостоятельно.

Значения по умолчанию цвета и шрифта всплывающей подсказки могут быть изменены с помощью setPalette() и setFont(). Когда всплывающая подсказка отображается, isVisible() возвращает true, а text() — текущий отображаемый текст.

Примечание: Всплывающие подсказки используют пассивную группу цветов QPalette, потому что они не являются активными окнами.

См. также QWidget::toolTip, QAction::toolTip и Пример подсказок.

Документация по функциям-членам

[static] QFont QToolTip::font()

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

Эта функция была добавлена в Qt 4.2.

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

[static] void QToolTip::hideText()

Скрывает всплывающую подсказку. Это то же самое, что вызов showText() с пустой строкой.

Эта функция была добавлена в Qt 4.2.

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

[static] bool QToolTip::isVisible()

Возвращает true, если эта подсказка в настоящее время отображается.

Эта функция была добавлена в Qt 4.4.

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

[static] QPalette QToolTip::palette()

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

Примечание: Всплывающие подсказки используют пассивную группу цветов QPalette, потому что они не являются активными окнами.

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

[static] void QToolTip::setFont(const QFont &font)

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

Эта функция была добавлена в Qt 4.2.

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

[static] void QToolTip::setPalette(const QPalette &palette)

Устанавливает палитру, используемую для отображения всплывающих подсказок.

Примечание: Всплывающие подсказки используют пассивную группу цветов QPalette, потому что они не являются активными окнами.

Эта функция была добавлена в Qt 4.2.

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

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w, const QRect &rect)

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

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

rect указан в координатах виджета, указанного с помощью w. Если rect не пустой, вы должны указать виджет. В противном случае этот аргумент может быть 0, но используется для определения соответствующего экрана на многоэкранных системах.

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

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w = nullptr)

Это перегруженная функция.

Это аналогично вызову QToolTip::showText(pos, text, w, QRect())

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w, const QRect &rect, int msecDisplayTime)

Это перегруженная функция.

Это аналогично QToolTip::showText(pos, text, w, rect), но с дополнительным параметром msecDisplayTime, который указывает, как долго будет отображаться всплывающая подсказка в миллисекундах.

Эта функция была добавлена в Qt 5.2.

[static] QString QToolTip::text()

Возвращает текст всплывающей подсказки, если она видима, или пустую строку, если всплывающая подсказка не видима.

Эта функция была добавлена в Qt 4.4.