ToolTip QML Type

모든 컨트롤에 대한 도구 팁을 제공합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

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

첨부 속성

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

방법

• void hide() (since QtQuick.Controls 2.5 (Qt 5.12))
• void show(string text, int timeout) (since QtQuick.Controls 2.5 (Qt 5.12))

첨부 메서드

• void hide()
• void show(string text, int timeout)

상세 설명

도구 설명은 사용자에게 컨트롤의 기능을 알려주는 짧은 텍스트입니다. 일반적으로 상위 컨트롤의 위 또는 아래에 배치됩니다. 팁 텍스트는 서식 있는 텍스트 형식의 문자열이면 됩니다.

첨부된 도구 팁

컨트롤에 대한 도구 팁을 설정하는 가장 간단한 방법은 첨부 속성을 통해 text 및 visibility 을 지정하는 것입니다. 다음 예제는 이 방법을 보여줍니다:

Button {
    text: qsTr("Save")

    ToolTip.visible: down
    ToolTip.text: qsTr("Save the active project")
}

일반적인 상황에서는 한 번에 하나의 도구 팁만 표시됩니다. 리소스를 절약하기 위해 툴팁 첨부 속성을 사용하는 모든 항목은 동일한 시각적 툴팁 레이블 인스턴스를 공유합니다. 비주얼이 공유되더라도 text, timeout 및 delay 은 해당 첨부 속성을 사용하는 각 항목에 대해 개별적으로 저장됩니다. 그러나 여러 항목에서 공유 도구 설명이 동시에 표시될 수는 없습니다. 공유 도구 설명은 마지막으로 도구 설명을 표시한 항목에 대해서만 표시됩니다. 공유 도구 설명의 위치는 프레임워크에 의해 결정됩니다.

지연 및 시간 초과

툴 팁은 일반적으로 특정 외부 이벤트나 사용자 상호작용의 결과로 표시된다는 점에서 일시적이며, 일반적으로 특정 시간 초과 후에는 숨겨집니다. 툴팁이 표시되는 지연 시간과 숨겨지는 시간 제한을 제어할 수 있습니다. 이를 통해 툴 팁을 표시하고 숨기는 다양한 전략을 구현할 수 있습니다.

예를 들어 터치스크린에서는 버튼을 길게 누르면 도구 팁이 표시되는 것이 일반적인 패턴입니다. 다음 예는 길게 누르고 있는 간격에 도달할 때까지 도구 팁 표시를 지연시키는 방법을 보여줍니다. 이 예에서는 버튼에서 손을 떼자마자 도구 설명이 숨겨집니다.

Button {
    text: qsTr("Button")

    ToolTip.visible: pressed
    ToolTip.delay: Application.styleHints.mousePressAndHoldInterval
    ToolTip.text: qsTr("This tool tip is shown after pressing and holding the button down.")
}

그러나 포인터 장치를 사용하는 경우에는 버튼을 잠시 동안 마우스를 가져가면 도구 팁을 표시하고 싶을 수 있습니다. 다음 예에서는 버튼을 1초 동안 마우스를 가져간 후 도구 팁을 표시하고 5초의 시간 초과 후에 도구 팁을 숨기는 방법을 설명합니다.

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

사용자 지정 도구 팁

툴팁 위치를 보다 세밀하게 제어해야 하거나 여러 개의 툴팁 인스턴스가 동시에 필요한 경우 로컬 툴팁 인스턴스를 만들 수도 있습니다. 이렇게 하면 툴 팁을 사용자 지정할 수 있으며 전체 Popup API를 사용할 수 있습니다. 다음 예는 핸들을 끌었을 때 슬라이더의 값을 표시하는 툴팁을 보여줍니다.

Slider {
    id: slider
    value: 0.5

    ToolTip {
        parent: slider.handle
        visible: slider.pressed
        text: slider.value.toFixed(1)
    }
}

툴팁 사용자 지정하기, 팝업 컨트롤 및 closePolicy 를참조하세요 .

속성 문서

첨부 속성 문서

메서드 문서

첨부된 메서드 문서