INSERTPSUIPAGE_INFO構造体 (compstui.h)

[アーティクル]
02/22/2024

INSERTPSUIPAGE_INFO構造体は、関数コードがCPSFUNC_INSERT_PSUIPAGEされている場合、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 パラメーターは、子のセット内で指定されたページを挿入する場所を示す 0 から始まるインデックスを指定します。 lParam1 が 0 の場合、ページは 1 ページ目から挿入されます。lParam1 が 1 の場合、ページは 2 ページ目から挿入されます。などなど。インデックスが既存の子の数より大きい場合は、新しいページが最後の子として追加されます。 lParam1 値は、HINSPSUIPAGE_INDEX(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 型の関数に渡されます。