QWhatsThis Class

자세한 설명

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

QWhatsThis는 사용자가 "이게 뭐예요?"라고 물으면 팝업으로 표시되는 설명 텍스트가 포함된 단일 창을 제공합니다. 사용자가 질문하는 기본 방법은 관련 위젯으로 초점을 이동하고 Shift+F1을 누르는 것입니다. 도움말 텍스트는 즉시 표시되며 사용자가 다른 작업을 하면 바로 사라집니다. (Shift+F1 단축키가 있는 경우에는 이 메커니즘이 작동하지 않습니다.) 일부 대화 상자에는 사용자가 '?' 버튼을 클릭하여 "무엇을 하나요?" 모드로 들어간 다음 관련 위젯을 클릭하여 "무엇을 하나요?" 창을 띄울 수 있는 '?' 버튼이 제공됩니다. 메뉴 옵션이나 툴바 버튼을 제공하여 "무엇인가요?" 모드로 전환할 수도 있습니다.

위젯이나 동작에 "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."));

"이게 뭐예요?" 모드로 들어가는 다른 방법은 createAction()를 호출하고 반환된 QAction 을 메뉴나 툴바에 추가하는 것입니다. 이 상황에 맞는 도움말 동작(아래 그림에서 화살표와 물음표 아이콘이 있는 버튼)을 호출하면 사용자가 "무엇인가요?" 모드로 전환됩니다. 이제 위젯을 클릭하면 적절한 도움말 텍스트가 표시됩니다. 도움말이 제공되거나 사용자가 Esc 키를 누르면 이 모드는 그대로 유지됩니다.

enterWhatsThisMode()를 사용하여 프로그래밍 방식으로 "무엇인가요?" 모드로 들어가서 inWhatsThisMode()로 모드를 확인하고 leaveWhatsThisMode()로 일반 모드로 돌아갈 수 있습니다.

위젯의 "무엇인가요?" 동작을 수동으로 제어하려면 Qt::WA_CustomWhatsThis 을 참조하세요.

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