# QWhatsThis Class Reference ## [[QtGui](index.htm) module] 該QWhatsThis類提供的任何部件的簡單描述，即回答“這是什么？ ” 。[More...](#details) ### Methods * `__init__ (self, QWhatsThis)` ### Static Methods * `QAction createAction (QObject?parent?=?None)` * `enterWhatsThisMode ()` * `hideText ()` * `bool inWhatsThisMode ()` * `leaveWhatsThisMode ()` * `showText (QPoint?pos, QString?text, QWidget?widget?=?None)` * * * ## Detailed Description 該QWhatsThis類提供的任何部件的簡單描述，即回答“這是什么？ ” 。 “這是什么？ ”幫助是一個應用程序的聯機幫助系統的一部分，并為用戶提供有關特定組件的功能和使用信息。 “這是什么？ ”幫助文本通常是更長，更詳細的比[tooltips](qtooltip.html)，但通常提供比由單獨的幫助窗口提供的信息較少。 QWhatsThis提供單一窗口彈出當用戶要求的說明文字“這是什么？ ” 。默認方式為用戶問的問題是將焦點移動到相關窗口小部件，然后按Shift + F1鍵。幫助文本立即出現，它就會消失，一旦用戶做別的東西。 （請注意，如果有一個Shift + F1鍵的快捷方式，這種機制將不起作用。 ）某些對話框提供了一個“ ？ ”按鈕，用戶可以點擊進入“這是什么？ ”模式，它們然后單擊相關的小工具，彈出“這是什么？ ”窗口。它也可以提供AA選項菜單或工具欄按鈕，切換到“這是什么？ ”模式。 要添加“這是什么？ ”文本窗口小部件或一個動作，你只需要調用[QWidget.setWhatsThis](qwidget.html#whatsThis-prop)（）或[QAction.setWhatsThis](qaction.html#whatsThis-prop)（ ） 。 文本可以是富文本或純文本。如果指定了豐富的文本格式的字符串，它會使用默認的樣式表來呈現，從而有可能在顯示的文本插入圖片。要盡可能快，默認的樣式表使用一個簡單的方法來確定文本是否可以呈現為純文本。看[Qt.mightBeRichText](qt.html#mightBeRichText)（ ）了解詳情。 ``` newAct = new [QAction](qaction.html)(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](qwhatsthis.html#createAction)（ ） ，并添加返回[QAction](qaction.html)要么菜單或工具欄。通過調用這方面的幫助作用（在下面的圖片，用箭頭和問號圖標的按鈕） ，用戶切換到“這是什么？ ”模式。如果他們現在點擊窗口小部件會顯示相應的說明文字。當幫助時或者當用戶按下Esc鍵的方式離開了。  您可以輸入“這是什么？ ”模式與編程[enterWhatsThisMode](qwhatsthis.html#enterWhatsThisMode)（ ） ，檢查模式[inWhatsThisMode](qwhatsthis.html#inWhatsThisMode)（ ） ，并返回到正常模式[leaveWhatsThisMode](qwhatsthis.html#leaveWhatsThisMode)（ ） 。 如果你想控制的“這是什么？ ”一個小部件的行為手動見[Qt.WA_CustomWhatsThis](qt.html#WidgetAttribute-enum)。 另外，也可以顯示不同的幫助文本窗口小部件的不同區域，通過使用[QHelpEvent](qhelpevent.html)類型[QEvent.WhatsThis](qevent.html#Type-enum)。攔截在你的widget的幫助事件[QWidget.event](qwidget.html#event)（ ）函數和調用[QWhatsThis.showText](qwhatsthis.html#showText)（ ）與文本要顯示在指定的位置[QHelpEvent.pos](qhelpevent.html#pos)（ ） 。如果文本是豐富的文本和用戶點擊一個鏈接時，窗口小部件也接收[QWhatsThisClickedEvent](qwhatsthisclickedevent.html)與該鏈接的引用作為[QWhatsThisClickedEvent.href](qwhatsthisclickedevent.html#href)（ ） 。如果[QWhatsThisClickedEvent](qwhatsthisclickedevent.html)處理（即[QWidget.event](qwidget.html#event)（ ）返回True ） ，幫助窗口仍然可見。通話[QWhatsThis.hideText](qwhatsthis.html#hideText)（ ）顯式地將其隱藏。 * * * ## Method Documentation ``` QWhatsThis.__init__ (self, QWhatsThis) ``` ``` QAction QWhatsThis.createAction (QObject?parent?=?None) ``` [ 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 ](qaction.html) [返回一個現成的](qaction.html)[QAction](qaction.html)，用于調用“這是什么？ ”上下文幫助，用給定的_parent_。 返回[QAction](qaction.html)提供了一個便捷的方式，讓用戶輸入“這是什么？ ”模式。 ``` QWhatsThis.enterWhatsThisMode () ``` 該功能切換用戶界面進入“這是什么？ ”模式。用戶界面可以切換回正常模式由用戶（例如，通過他們點擊或按下Esc鍵） ，或以編程方式通過調用[leaveWhatsThisMode](qwhatsthis.html#leaveWhatsThisMode)（ ） 。 當進入“這是什么？ ”模式中，一個[QEvent](qevent.html)類型Qt.EnterWhatsThisMode被發送到所有頂層窗口小部件。 **See also** [inWhatsThisMode](qwhatsthis.html#inWhatsThisMode)（）和[leaveWhatsThisMode](qwhatsthis.html#leaveWhatsThisMode)（ ） 。 ``` QWhatsThis.hideText () ``` 如果“這是什么？ ”窗口顯示，這會破壞它。 **See also** [showText](qwhatsthis.html#showText)（ ） 。 ``` bool QWhatsThis.inWhatsThisMode () ``` 返回True如果用戶界面是“這是什么？ ”模式，否則返回False 。 **See also** [enterWhatsThisMode](qwhatsthis.html#enterWhatsThisMode)（ ） 。 ``` QWhatsThis.leaveWhatsThisMode () ``` 如果用戶界面是“這是什么？ ”模式下，該功能切換回正常模式，否則它什么也不做。 當離開“這是什么？ ”模式中，一個[QEvent](qevent.html)類型Qt.LeaveWhatsThisMode被發送到所有頂層窗口小部件。 **See also** [enterWhatsThisMode](qwhatsthis.html#enterWhatsThisMode)（）和[inWhatsThisMode](qwhatsthis.html#inWhatsThisMode)（ ） 。 ``` QWhatsThis.showText (QPoint?pos, QString?text, QWidget?widget?=?None) ``` Shows _text_作為一個“這是什么？ ”窗口，在全球地位_pos_。可選的窗口小部件的參數，_w_，用于確定在多磁頭系統相應的屏幕。 **See also** [hideText](qwhatsthis.html#hideText)（ ） 。