共用方式為

INSERTPSUIPAGE_INFO 結構 (compstui.h)

  • 發行項

如果函式程式代碼CPSFUNC_INSERT_PSUIPAGE，INSERTPSUIPAGE_INFO 結構會當做 CPSUI ComPropSheet 函式的輸入參數使用。 ComPropSheet 呼叫端必須提供所有成員值。

語法

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

成員

cbSize

呼叫端提供的大小，以位元組為單位，INSERTPSUIPAGE_INFO 結構。

Type

呼叫端提供的整數值，指出要求的插入類型。 成員可以包含下列其中一個常數：

PSUIPAGEINSERT_DLL

CPSUI 會呼叫指定的 PFNPROPSHEETUI 具型別函式，其原因值為 PROPSHEETUI_REASON_INIT。 函式包含在個別的 DLL 中。

PSUIPAGEINSERT_GROUP_PARENT

CPSUI 會建立新的 群組父代。

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI 會插入已呼叫 CreatePropertySheetPage 所建立的頁面。

(這相當於使用函式程式代碼CPSFUNC_ADD_HPROPSHEETPAGE.) 呼叫 ComPropSheet

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI 會插入 COMPROPSHEETUI 結構所描述的頁面。

(這相當於使用函式程式代碼CPSFUNC_ADD_PCOMPROPSHEETUI.) 呼叫 ComPropSheet

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI 會呼叫指定的 PFNPROPSHEETUI 具型別函式，其原因值為 PROPSHEETUI_REASON_INIT。

(這相當於使用函式程式代碼CPSFUNC_ADD_PFNPROPSHEETUI.) 呼叫 ComPropSheet

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI 會插入指定的 PROPSHEETPAGE 結構所描述的頁面。

(這相當於使用函式程式代碼CPSFUNC_ADD_PROPSHEETPAGE.) 呼叫 ComPropSheet

Mode

呼叫端提供的值，指出 CPSUI 應該插入新頁面的位置。 它必須是下列其中一個值：

INSPSUIPAGE_MODE_AFTER

CPSUI 會在 由 lParam1 參數所指定的 CPSUI 頁面句柄所識別的頁面之後插入頁面 至 ComPropSheet。

INSPSUIPAGE_MODE_BEFORE

CPSUI 會在由 lParam1 參數指定的 CPSUI 頁面句柄所識別的頁面之前插入頁面 至 ComPropSheet。

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI 會將頁面插入為 hComPropSheet 參數所識別父群組的第一個子系至 ComPropSheet。

忽略 ComPropSheet 的 lParam1 參數。

INSPUIPAGE_MODE_INDEX

CPSUI 會將頁面當做 hComPropSheet 參數所識別父群組的子系插入 ComPropSheet。

ComPropSheet 的 lParam1 參數會指定以零起始的索引，識別子系集合內應該插入指定的頁面。 如果 lParam1 為 0，則會從第 1 頁開始插入頁面;如果 lParam1 為 1 ，則會從第 2 頁開始插入頁面;依此類故。 如果索引大於現有子系的數目，新頁面會新增為最後一個子系。 lParam1 值必須指定為索引) HINSPSUIPAGE_INDEX (。

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI 會將頁面插入為 hComPropSheet 參數所識別父群組的最後一個子系至 ComPropSheet。

忽略 ComPropSheet 的 lParam1 參數。

dwData1

請參閱下方 的 一節。

dwData2

請參閱下方 的 一節。

dwData3

請參閱下方 的 一節。

備註

dwData1、dwData2 和 dwData3 成員包含呼叫端提供的值，這些值取決於 Type 成員的內容，如下所示：

類型成員包含PSUIPAGEINSERT_DLL

dwData1 - 呼叫端提供的指標，代表 DLL 路徑名稱的 NULL 終止字串。

dwData2 - 呼叫端提供的指標，代表指定 DLL 中包含的 PFNPROPSHEETUI 具型別函式名稱的 NULL 終止字串。

dwData3 - 呼叫端提供的 32 位值，傳遞至其 lParam 參數的 PFNPROPSHEETUI 型別函式。

類型成員包含PSUIPAGEINSERT_GROUP_PARENT

dwData1 - 未使用，必須是零。

dwData2 - 未使用，必須是零。

dwData3 - 未使用，必須是零。

類型成員包含PSUIPAGEINSERT_HPROPSHEETPAGE

dwData1 - 由 CreatePropertySheetPage 傳回之屬性表的呼叫端提供句柄。

dwData2 - 未使用，必須是零。

dwData3 - 未使用，必須是零。

類型成員包含PSUIPAGEINSERT_PCOMPROPSHEETUI

dwData1 - 呼叫端提供的 COMPROPSHEETUI 結構指標。

dwData2 - 成功時，會收到插入的頁數。 失敗時，會收到ERR_CPSUI前置錯誤碼。

dwData3 - 未使用，必須是零。

類型成員包含PSUIPAGEINSERT_PFNPROPSHEETUI

dwData1 - PFNPROPSHEETUI 型別函式的呼叫端提供指標。

dwData2 - 呼叫端提供的 32 位值，傳遞給其 lParam 參數的 PFNPROPSHEETUI 型別函式。

dwData3 - 未使用，必須是零。

類型成員包含PSUIPAGEINSERT_PROPSHEETPAGE

dwData1 - 呼叫端提供的 PROPSHEETPAGE 結構的指標。

dwData2 - 未使用，必須是零。

dwData3 - 未使用，必須是零。

規格需求

需求 值
標頭 compstui.h (包括 Compstui.h)