QWhatsThis Class

상세 설명

"What's This?" 도움말은 애플리케이션의 온라인 도움말 시스템의 일부로, 사용자에게 특정 위젯의 기능 및 사용법에 대한 정보를 제공합니다. "What's This?" 도움말 텍스트는 일반적으로 " tooltips"보다 길고 상세하지만, 별도의 도움말 창에서 제공하는 정보보다는 일반적으로 정보가 적습니다.

QWhatsThis는 사용자가 "What's This?"를 요청할 때 설명 텍스트가 포함된 단일 창을 표시합니다. 사용자가 이 질문을 하는 기본 방법은 관련 위젯으로 포커스를 이동한 후 Shift+F1을 누르는 것입니다. 도움말 텍스트는 즉시 표시되며, 사용자가 다른 작업을 수행하면 바로 사라집니다. (Shift+F1에 대한 단축키가 설정되어 있는 경우, 이 메커니즘은 작동하지 않습니다.) 일부 대화 상자에는 사용자가 클릭하여 “What’s This?” 모드로 진입할 수 있는 “?” 버튼이 제공되며, 이때 관련 위젯을 클릭하면 “What’s This?” 창이 팝업으로 나타납니다. 또한 메뉴 옵션이나 툴바 버튼을 통해 “What’s This?” 모드로 전환할 수도 있습니다.

위젯이나 액션에 “이게 뭐죠?” 텍스트를 추가하려면 QWidget::setWhatsThis() 또는 QAction::setWhatsThis()를 호출하기만 하면 됩니다.

텍스트는 서식이 지정된 텍스트(리치 텍스트)이거나 일반 텍스트(플레인 텍스트)일 수 있습니다. 서식이 지정된 문자열을 지정하면 기본 스타일시트를 사용하여 렌더링되므로, 표시된 텍스트에 이미지를 삽입할 수 있습니다. 처리 속도를 최대한 높이기 위해 기본 스타일시트는 텍스트를 일반 텍스트로 렌더링할 수 있는지 여부를 판단하는 간단한 방법을 사용합니다. 자세한 내용은 Qt::mightBeRichText()을 참조하십시오.

newAct = new QAction(tr("&New"), this);
newAct->setShortcut(tr("Ctrl+N"));
newAct->setStatusTip(tr("Create a new file"));
newAct->setWhatsThis(tr("Click this option to create a new file."));

"What's This?" 모드로 진입하는 또 다른 방법은 createAction()를 호출하고, 반환된 QAction 를 메뉴나 도구 모음에 추가하는 것입니다. 이 컨텍스트 도움말 동작(아래 그림에서 화살표와 물음표 아이콘이 있는 버튼)을 호출하면 사용자는 "What's This?" 모드로 전환됩니다. 이제 사용자가 위젯을 클릭하면 해당 도움말 텍스트가 표시됩니다. 도움말이 제공되거나 사용자가 Esc 키를 누르면 이 모드가 종료됩니다.

enterWhatsThisMode()를 사용하여 프로그래밍 방식으로 "What's This?" 모드로 진입할 수 있으며, inWhatsThisMode()로 모드를 확인하고, leaveWhatsThisMode()로 일반 모드로 돌아갈 수 있습니다.

위젯의 “What's This?” 동작을 수동으로 제어하려면 Qt::WA_CustomWhatsThis 를 참조하십시오.

또한 QEvent::WhatsThis 유형의 QHelpEvent 을 사용하여 위젯의 영역마다 다른 도움말 텍스트를 표시할 수도 있습니다. 위젯의 QWidget::event() 함수에서 도움말 이벤트를 가로채고, QHelpEvent::pos()에서 지정된 위치에 표시할 텍스트를 사용하여 QWhatsThis::showText()를 호출하십시오. 텍스트가 서식 있는 텍스트이고 사용자가 링크를 클릭하면, 위젯은 QWhatsThisClickedEvent::href()로 링크의 참조를 포함한 QWhatsThisClickedEvent 도 수신합니다. QWhatsThisClickedEvent 가 처리되는 경우(즉, QWidget::event()가 true를 반환하는 경우), 도움말 창은 계속 표시됩니다. QWhatsThis::hideText()를 호출하여 명시적으로 숨기십시오.