PropSheet_InsertPage宏 (prsht.h)
將新頁面插入現有的屬性表。 頁面可以插入指定的索引處或指定的頁面之後。 您可以使用這個宏,或明確傳送 PSM_INSERTPAGE 訊息。
語法
void PropSheet_InsertPage(
hDlg,
index,
hpage
);
參數
hDlg
類型: HWND
屬性表的句柄。
index
類型: HWND
要插入頁面的位置。 將 wParam 設定為 NULL ,讓新頁面成為第一頁。 若要指定要插入新頁面的位置,您可以傳遞索引或現有頁面的 HPROPSHEETPAGE 句柄。
hpage
類型: HWND
要插入之頁面的句柄。 必須先呼叫 CreatePropertySheetPage 函式來建立頁面。
傳回值
無
備註
插入點之後的頁面會向右移位,以容納新的頁面。
屬性表不會重設大小以符合新頁面。 請勿讓新頁面大於屬性表的最大頁面。
屬性表正在操作頁面清單時,會發生一些訊息和一個函數調用。 當此動作發生時,嘗試修改頁面清單將會產生無法預期的結果。 因此,您不應該在 PropSheetPageProc 的實作中使用 PropSheet_InsertPage 宏,或在處理下列通知和 Windows 訊息時使用。
如果您在處理其中一則訊息或 PropSheetPageProc 運作時,需要修改屬性表頁面,請張貼私人 Windows 訊息。 在屬性表管理員完成其工作之前,您的應用程式將不會收到該訊息。 然後您可以修改頁面清單。下列通知也會受到屬性表修改的影響。
您可以新增或移除頁面以回應這些通知,前提是您可以透過DWL_MSGRESULT) 非零值传回 (,以指定所需的新頁面。 不過請注意,如果您插入位於目前頁面之前的頁面 (索引小於目前頁面 ) ,PSN_KILLACTIVE 可能會傳送到錯誤的頁面。
注意 使用 (精靈樣式 (PSH_AEROWIZARD ) 時,不支援此宏。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | prsht.h |