QWhatsThis 类

详细描述

"这是什么？" 帮助是应用程序联机帮助系统的一部分，为用户提供有关特定小部件的功能和使用信息。"这是什么？" 帮助文本通常比 工具提示 长且更详细，但通常提供的信息少于单独的帮助窗口。

QWhatsThis 在用户询问“这是什么？”时弹出一个带有解释文本的单个窗口。用户询问问题的默认方式是将焦点移动到相关小部件并按 Shift+F1。帮助文本立即出现；用户做其他事情时就会消失。（注意，如果存在 Shift+F1 的快捷键，此机制将不起作用。）某些对话框提供了一个用户可以点击以进入“这是什么？”模式的“？”按钮；然后他们点击相关的小部件以弹出“这是什么？”窗口。还可以提供一个菜单选项或工具栏按钮来切换到“这是什么？”模式。

要将“这是什么？”文本添加到小部件或操作中，只需调用 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 为小部件的不同区域显示不同的帮助文本。在您的 widget 的 QWidget::event() 函数中拦截帮助事件，并以在 QHelpEvent::pos 中指定的位置显示的文本调用 QWhatsThis::showText()。如果文本是富文本并且用户点击了链接，widget 还会接收到带有链接引用作为 QWhatsThisClickedEvent::href 的 QWhatsThisClickedEvent。如果处理了 QWhatsThisClickedEvent（即 QWidget::event() 返回 true），则帮助窗口保持可见。调用 QWhatsThis::hideText() 以显式地隐藏它。