PropSheet_AddPage巨集 (prsht.h)
將新頁面加入至現有屬性表的結尾。 您可以使用此巨集或明確傳送 PSM_ADDPAGE 訊息。
語法
BOOL PropSheet_AddPage(
HWND hDlg,
HPROPSHEETPAGE hpage
);
參數
hDlg
類型:HWND
屬性表的句柄。
hpage
類型:HPROPSHEETPAGE
要新增的頁面句柄。 頁面必須由先前呼叫 CreatePropertySheetPage 函式所建立。
傳回值
類型:BOOL
如果成功,則傳回 true true,否則會 傳回 false。
言論
新頁面應該不會大於屬性表中目前最大的頁面,因為屬性表未重設大小以符合新頁面。
當屬性表正在操作頁面清單時,會發生許多訊息和一個函數調用。 執行此動作時,嘗試修改頁面清單將會產生無法預期的結果。 因此,您不應該在實作 PropSheetPageProc 或處理下列通知和Microsoft Windows 訊息時使用 PropSheet_AddPage 巨集:
如果您需要在處理其中一則訊息時修改屬性表頁面,或 PropSheetPageProc 運作時,請自行張貼私人 Windows 訊息。 在屬性表管理員完成其工作之後,您的應用程式才會收到該訊息。 然後,您可以修改頁面清單。要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | prsht.h |