Back to Qt.io
Contact Us Blog Download Qt

QToolTip Class

QToolTip 클래스는 모든 위젯에 대한 도구 팁(풍선 도움말)을 제공합니다. 더 보기...

Header: #include <QToolTip>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

정적 공용 멤버

QFont font()
void hideText()
bool isVisible()
QPalette palette()
void setFont(const QFont &font)
void setPalette(const QPalette &palette)
void showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)
QString text()

자세한 설명

팁은 사용자에게 위젯의 기능을 알려주는 짧은 텍스트입니다. 팁은 지정된 위치 바로 아래에 검은색과 노란색의 독특한 색상 조합으로 그려집니다. 팁은 rich text 형식의 문자열이면 됩니다.

도구 팁에 표시되는 서식 있는 텍스트는 <p style='white-space:pre'> 로 달리 지정하지 않는 한 암시적으로 단어 줄 바꿈됩니다.

QAction 을 통해 생성된 UI 요소는 QAction 의 도구 설명 속성을 사용하므로 대부분의 대화형 UI 요소의 경우 해당 속성을 설정하는 것이 도구 설명을 제공하는 가장 쉬운 방법입니다.

    QAction *openAction = new QAction(tr("&Open..."));
    openAction->setToolTip(tr("Open an existing file"));

    fileMenu = menuBar()->addMenu(tr("&File"));
    fileToolBar = addToolBar(tr("&File"));

    fileMenu->addAction(openAction);
    fileToolBar->addAction(openAction);

다른 위젯의 경우 위젯의 툴팁을 설정하는 가장 간단하고 일반적인 방법은 QWidget::setToolTip() 함수를 호출하는 것입니다.

    searchBar = new SearchBar;
    searchBar->setToolTip(tr("Search in the current document"));

QEvent::ToolTip 유형의 QHelpEvent 을 사용하여 위젯의 영역별로 다른 툴팁을 표시할 수도 있습니다. 위젯의 event() 함수에서 도움말 이벤트를 가로채서 표시하려는 텍스트로 QToolTip::showText()을 호출합니다.

bool Window::event(QEvent *event)
{
    if (event->type() == QEvent::ToolTip) {
        QHelpEvent *helpEvent = static_cast<QHelpEvent *>(event);
        if (Element *element = elementAt(helpEvent->pos())) {
            QToolTip::showText(helpEvent->globalPos(), element->toolTip());
        } else {
            QToolTip::hideText();
            event->ignore();
        }

        return true;
    }
    return QWidget::event(event);
}

ToolTip- 이벤트의 결과로 빈 문자열로 QToolTip::hideText() 또는 QToolTip::showText()을 호출하는 경우에는 이벤트에 ignore()도 호출하여 툴팁 특정 모드를 시작하지 않겠다는 신호를 보내야 합니다.

항목 보기에 툴팁을 표시하려면 모델/보기 아키텍처에서 항목의 툴팁을 설정하는 기능(예: QTableWidgetItem::setToolTip() 함수)을 제공한다는 점에 유의하세요. 그러나 항목 보기에서 사용자 지정 도구 설명을 제공하려면 QAbstractItemView::viewportEvent() 함수에서 도움말 이벤트를 가로채서 직접 처리해야 합니다.

setPalette() 및 setFont()를 사용하여 기본 도구 설명 색상 및 글꼴을 사용자 지정할 수 있습니다. 현재 도구 설명이 표시되어 있는 경우 isVisible()는 true 및 text()에 현재 표시된 텍스트를 반환합니다.

참고: 도구 설명은 활성 창이 아니므로 도구 설명은 비활성 색상 그룹인 QPalette 을 사용합니다.

QWidget::toolTip 및 QAction::toolTip 을참조하세요 .

멤버 함수 문서

[static] QFont QToolTip::font()

도구 설명을 렌더링하는 데 사용되는 글꼴을 반환합니다.

setFont()도 참조하세요 .

[static] void QToolTip::hideText()

도구 도움말을 숨깁니다. 이는 빈 문자열로 showText()를 호출하는 것과 동일합니다.

showText()도 참조하세요 .

[static] bool QToolTip::isVisible()

현재 툴팁이 표시되어 있으면 true 을 반환합니다.

showText()도 참조하세요 .

[static] QPalette QToolTip::palette()

도구 설명을 렌더링하는 데 사용된 팔레트를 반환합니다.

참고: 도구 설명은 활성 창이 아니므로 도구 설명은 비활성 색상 그룹 QPalette 을 사용합니다.

setPalette()도 참조하세요 .

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

도구 설명을 렌더링하는 데 사용되는 font 을 설정합니다.

font()도 참조하세요 .

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

도구 설명을 렌더링하는 데 사용되는 palette 을 설정합니다.

참고: 도구 설명은 활성 창이 아니므로 도구 설명은 비활성 색상 그룹인 QPalette 을 사용합니다.

palette()도 참조하세요 .

[static] void QToolTip::showText(const QPoint &pos, const QString &text, QWidget *w = nullptr, const QRect &rect = {}, int msecDisplayTime = -1)

text 을 툴팁으로 표시하고, 글로벌 위치 pos 을 관심 지점으로 표시합니다. 툴팁은 이 관심 지점에서 플랫폼별 오프셋과 함께 표시됩니다.

비어 있지 않은 직사각형을 지정하면 커서를 이 영역 밖으로 이동하는 즉시 팁이 숨겨집니다.

rect 은 w 으로 지정한 위젯의 좌표에 있습니다. rect 이 비어 있지 않은 경우 위젯을 지정해야 합니다. 그렇지 않으면 이 인수는 nullptr 일 수 있지만 멀티 헤드 시스템에서 적절한 화면을 결정하는 데 사용됩니다.

msecDisplayTime 매개변수는 도구 설명이 표시될 기간을 밀리초 단위로 지정합니다. 기본값이 -1인 경우 시간은 텍스트 길이를 기준으로 합니다.

text 이 비어 있으면 툴팁이 숨겨집니다. 텍스트가 현재 표시된 툴팁과 동일한 경우 툴팁은 움직이지 않습니다. 먼저 빈 텍스트로 팁을 숨긴 다음 새 위치에 새 팁을 표시하여 강제로 이동할 수 있습니다.

[static] QString QToolTip::text()

툴팁이 표시되는 경우 툴팁 텍스트를 반환하고, 툴팁이 표시되지 않는 경우 빈 문자열을 반환합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.