共用方式為

PropSheet_SetWizButtons巨集 （prsht.h）

  • 發行項

藉由張貼 PSM_SETWIZBUTTONS 訊息，啟用或停用精靈中的 [上一步]、[下一步] 和 [完成] 按鈕。 您可以使用此巨集或明確傳送 PSM_SETWIZBUTTONS 訊息。

語法

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

參數

hDlg

類型：HWND

屬性表的句柄。

dwFlags

類型：DWORD

值，指定已啟用哪些精靈按鈕。 您可以結合下列一或多個旗標。

價值 意義
PSWIZB_BACK
 啟用 [上一頁] 按鈕。 如果未設定此旗標，[上一頁] 按鈕會顯示為停用。
PSWIZB_DISABLEDFINISH
 顯示已停用的 [完成] 按鈕。
PSWIZB_FINISH
 顯示已啟用的 [完成] 按鈕。
PSWIZB_NEXT
 啟用 [下一步] 按鈕。 如果未設定此旗標，[下一步] 按鈕會顯示為停用。

傳回值

類型：VOID

沒有傳回值。

言論

此巨集會使用 PostMessage 來傳送 PSM_SETWIZBUTTONS 訊息。 如果您的通知處理程式呼叫 PropSheet_SetWizButtons，則不會對視窗焦點造成任何影響，直到處理程式傳回之後。 例如，如果您在呼叫 PropSheet_SetWizButtons之後立即呼叫 MessageBox ，消息框將會收到焦點。 由於傳送 PostMessage 的訊息在到達消息佇列的前端之前不會傳遞，因此在精靈失去焦點至消息框之後，才會傳遞 PSM_SETWIZBUTTONS 訊息。 因此，屬性表將無法正確設定按鈕的焦點。

精靈會顯示每個頁面下方的三個或四個按鈕。 此訊息用來指定已啟用哪些按鈕。 精靈通常會顯示 [上一步]、[取消] 和 [下一步] 或 [完成] 按鈕。 您通常只針對歡迎頁面啟用 [下一步] 按鈕、[下一步] 和 [上一頁] 代表內部頁面，以及完成頁面的 [上一步] 和 [完成]。 一律會啟用 [取消] 按鈕。 一般而言，設定PSWIZB_FINISH或PSWIZB_DISABLEDFINISH會以 [完成] 按鈕取代 [下一步] 按鈕。 若要同時顯示 [下一步] 和 [完成] 按鈕，請在建立精靈時，在精靈 PROPSHEETHEADER 結構 dwFlags 成員中設定 PSH_WIZARDHASFINISH FLAG。 然後，每個頁面都會顯示所有四個按鈕。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 prsht.h