次の方法で共有

INSERTPSUIPAGE_INFO構造体 (compstui.h)

  • [アーティクル]

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 型の関数に渡されます。

型メンバーに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 を含む)