次の方法で共有


PFNCOMPROPSHEET コールバック関数 (compstui.h)

ComPropSheet 関数は CPSUI によって提供され、CPSUI アプリケーション (プリンター インターフェイス DLL を含む) によって呼び出して、プロパティ シート ページをビルドできます。

構文

PFNCOMPROPSHEET Pfncompropsheet;

LONG_PTR Pfncompropsheet(
  [in] HANDLE hComPropSheet,
  [in] UINT Function,
  [in] LPARAM lParam1,
  [in] LPARAM lParam2
)
{...}

パラメーター

[in] hComPropSheet

プロパティ シート グループの親に対する呼び出し元指定のハンドル。 詳細については、「解説」を参照してください。

[in] Function

呼び出し元が指定した、CPSFUNC_プレフィックスが付いた ComPropSheet 関数コード。 ComPropSheet 関数によって実行される操作を指定します。 以下の「備考」セクションの ComPropSheet 関数コードの表を参照してください。

[in] lParam1

関数に指定された ComPropSheet 関数コードに依存する呼び出し元から指定された値。

[in] lParam2

関数に指定された ComPropSheet 関数コードに依存する呼び出し元から指定された値。

戻り値

戻り値は、Function に指定された ComPropSheet 関数コードによって異なります。

注釈

CPSUI は、アプリケーションの PFNPROPSHEETUI 型の関数の 1 つを呼び出すと、PROPSHEETUI_INFO構造体の ComPropSheet 関数へのポインターを渡します。 PFNPROPSHEETUI 型の関数は、ComPropSheet 関数を呼び出して、プロパティ シート ページを CPSUI に記述できます。

プリンター インターフェイス DLL は、DrvDocumentPropertySheets 関数またはその DrvDevicePropertySheets 関数内から ComPropSheet を呼び出すことができます。

Microsoft の Unidrv ドライバーと Pscript ドライバーのユーザー インターフェイス プラグインは、IPrintOemUI::D ocumentPropertySheets メソッドおよび IPrintOemUI::D evicePropertySheets メソッド内から ComPropSheet を呼び出すことができます。

hComPropSheet パラメーターに指定されたグループ親ハンドルは、次のいずれかになります。

  • PROPSHEETUI_INFO構造体の hComPropSheet メンバーで受け取ったハンドル。

  • CPSFUNC_INSERT_PSUIPAGE関数コードを使用して ComPropSheet を以前に呼び出し、INSERTPSUIPAGE_INFO構造体のType メンバーとしてPSUIPAGEINSERT_GROUP_PARENTを指定した結果として受け取ったハンドル。

ComPropSheet 関数コード

CPSUI の ComPropSheet 関数には、次の関数コードを渡すことができます。

CPSFUNC_ADD_HPROPSHEETPAGE

CPSFUNC_ADD_HPROPSHEETPAGE関数コードにより、ComPropSheet 関数は CreatePropertySheetPage 関数を呼び出して作成されたプロパティ シート ページを追加します。

パラメーター (CPSFUNC_ADD_HPROPSHEETPAGE)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出してプロパティ シート ページを追加するときに、この関数コード パラメーターを CPSFUNC_ADD_HPROPSHEETPAGE に設定します

  • lParam1: CreatePropertySheetPage 関数を呼び出して取得したプロパティ シート ページへのハンドル

  • lParam2: 使用されていません。0 にする必要があります

戻り値 (CPSFUNC_ADD_HPROPSHEETPAGE)

操作が成功すると、追加されたページに CPSUI ハンドルが返されます。それ以外の場合は NULL を返します。

CPSFUNC_ADD_PCOMPROPSHEETUI

CPSFUNC_ADD_PCOMPROPSHEETUI関数コードにより、ComPropSheet 関数は、COMPROPSHEETUI 構造体によって記述される 1 つ以上のプロパティ シート ページのセットを追加します。

パラメーター
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheetを呼び出して 1 つ以上のプロパティ シート ページのセットを追加するときに、この関数コード パラメーターを CPSFUNC_ADD_PCOMPROPSHEETUI に設定します

  • lParam1: COMPROPSHEETUI 構造体へのポインター

  • lParam2: 追加されたページ数を受け取る 32 ビットの場所へのポインター。エラーが発生した場合は、ERR_CPSUIプレフィックス付きのエラー コード

戻り値

操作が成功した場合、 ComPropSheet は追加されたページのセットへのハンドルを返します。それ以外の場合、関数は NULL を返します。

CPSFUNC_ADD_PFNPROPSHEETUI

CPSFUNC_ADD_PFNPROPSHEETUI関数コードにより、ComPropSheet 関数は指定された PFNPROPSHEETUI 型の関数を呼び出します。この関数は、1 つ以上のプロパティ シート ページのセットを追加する必要があります。

パラメーター (CPSFUNC_ADD_PFNPROPSHEETUI)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出すときに、この関数コード パラメーターをCPSFUNC_ADD_PFNPROPSHEETUIに設定します。 その後、ComPropSheet は、指定した PFNPROPSHEETUI 型の関数を呼び出して、1 つまたは複数のプロパティ シート ページのセットを追加します。

  • lParam1: PFNPROPSHEETUI 型の関数へのポインター

  • lParam2: その lParam パラメーターの PFNPROPSHEETUI 型の関数に渡される 32 ビット値

戻り値 (CPSFUNC_ADD_PFNPROPSHEETUI)

操作が成功した場合、 ComPropSheet は追加されたページのセットへのハンドルを返します。それ以外の場合、関数は NULL を返します。

CPSFUNC_ADD_PROPSHEETPAGE

CPSFUNC_ADD_PROPSHEETPAGE関数コードにより、ComPropSheet 関数は PROPSHEETPAGE 構造体によって記述されるプロパティ シート ページの種類を追加します。

パラメーター (CPSFUNC_ADD_PROPSHEETPAGE)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、COMPropSheet を呼び出して PROPSHEETPAGE 構造体で記述されたプロパティ シート ページの種類を追加するときに、この関数コード パラメーターを CPSFUNC_ADD_PROPSHEETPAGE に設定します。 ComPropSheet 関数は CreatePropertySheetPage 関数を呼び出し、PROPSHEETPAGE 構造体のアドレスを渡してページを作成します。

  • lParam1: PROPSHEETPAGE 構造体へのポインター

  • lParam2: 使用されていません。0 にする必要があります

戻り値 (CPSFUNC_ADD_PROPSHEETPAGE)

操作が成功すると、追加されたページに CPSUI ハンドルが返されます。それ以外の場合は NULL を返します。

CPSFUNC_DELETE_HCOMPROPSHEET

CPSFUNC_DELETE_HCOMPROPSHEET関数コードにより、ComPropSheet 関数は、CPSUI ハンドルによって指定されたプロパティ シート ページのセットを削除します。

パラメーター (CPSFUNC_DELETE_HCOMPROPSHEET)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出してプロパティ シート ページのセットを削除するときに、この関数コード パラメーターを CPSFUNC_DELETE_HCOMPROPSHEET に設定します

  • lParam1: 削除するページのセットを参照する CPSUI ハンドル。 このハンドルは、次のいずれかの関数コードを使用して ComPropSheet を呼び出すことによって以前に取得されている必要があります。

    • CPSFUNC_ADD_HPROPSHEETPAGE

    • CPSFUNC_ADD_PCOMPROPSHEETUI

    • CPSFUNC_ADD_PFNPROPSHEETUI

    • CPSFUNC_ADD_PROPSHEETPAGE

    • CPSFUNC_INSERT_PSUIPAGE

  • lParam2: 使用されていません。0 にする必要があります

戻り値 (CPSFUNC_DELETE_HCOMPROPSHEET)

ComPropSheet 関数は、削除されたプロパティ シート ページの数を返します。

CPSFUNC_DO_APPLY_CPSUI

CPSFUNC_DO_APPLY_CPSUI関数コードにより、comPropSheet 関数はPSN_APPLY通知メッセージの配信をシミュレートします。

CPSUI は 、アプリケーションの_CPSUICALLBACK 型コールバック関数に CPSUICB_REASON_APPLYNOW 理由を提供することで、CPSFUNC_DO_APPLY_CPSUI関数コードに応答します。

パラメーター (CPSFUNC_DO_APPLY_CPSUI)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、comPropSheet を呼び出してPSN_APPLY通知メッセージの配信をシミュレートするときに、この関数コード パラメーターを CPSFUNC_DO_APPLY_CPSUI に設定します

  • lParam1: 1 つ以上のプロパティ シート ページのセットを指す CPSUI ハンドル。 通常、このハンドルは、CPSFUNC_IGNORE_CPSUI_PSN_APPLY関数コードを使用して ComPropSheet に対する lParam1 パラメーターとして以前に指定されています。

  • lParam2: このパラメーターは、次のビット フラグの任意の組み合わせです。

    • APPLYCPSUI_NO_NEWDEF - 現在の既定値 (元に戻す操作に使用) を変更しない場合は、このフラグを設定します。 すべてのオプションの現在の値を元に戻す操作に使用される既定値にする場合は、このフラグをオフにします。

    • APPLYCPSUI_OK_CANCEL_BUTTON - ユーザーが [OK] または [キャンセル] ボタンを選択した場合 (またはこのアクティビティをシミュレートする場合) に、このフラグを設定します。 ユーザーが [今すぐ閉じる] または [今すぐ適用] ボタンを選択した場合 (またはこのアクティビティをシミュレートする場合) は、このフラグをオフにします。 PSN_APPLYメッセージを受信するようにコードが設定されている場合、コードは PSHNOTIFY 構造体の lParam メンバーをチェックする必要があります。 メンバーが 0 の場合は、このビットをクリアする必要があります。

戻り値 (CPSFUNC_DO_APPLY_CPSUI)

操作が成功した場合、 ComPropSheet 関数は 0 以外の値を返します。それ以外の場合は 0 を返し、指定したページはアクティブになります。

CPSFUNC_IGNORE_CPSUI_PSN_APPLY関数コードを使用して CPSUI によるPSN_APPLY通知メッセージの処理を無効にする場合は、CPSFUNC_DO_APPLY_CPSUI関数コードを使用して、PSN_APPLY メッセージの配信をシミュレートする必要があります。 それ以外の場合は、プロパティ シート ページに対するユーザーの変更を取得できません。

CPSFUNC_GET_HPSUIPAGES

CPSFUNC_GET_HPSUIPAGES関数コードにより、ComPropSheet 関数はプロパティ シート ページを指す CPSUI ハンドルの配列を返します。 これらのハンドルは、指定されたグループ親ハンドルに関連付けられている子ページを識別します。

この関数コードを使用するには、次の手順に従います。

  • CPSFUNC_GET_PAGECOUNT関数コードを指定して ComPropSheet を呼び出して、指定したグループの親に関連付けられている子ページの数を取得します。

  • 各ページの HANDLE 構造体を格納するのに十分なローカル メモリを割り当てます。

  • 再度 ComPropSheet を呼び出し、CPSFUNC_GET_HPSUIPAGES関数コードとローカルに割り当てられたメモリのアドレスを指定して HANDLE 構造体の配列を取得します。

パラメーター (CPSFUNC_GET_HPSUIPAGES)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して CPSUI ハンドルの配列を取得するときに、この関数コード パラメーターを CPSFUNC_GET_HPSUIPAGES に設定します

  • lParam1: HANDLE 構造体の配列へのポインター

  • lParam2: lParam1 が指す HANDLE 配列のサイズ

戻り値 (CPSFUNC_GET_HPSUIPAGES)

ComPropSheet 関数は、CPSUI が HANDLE 配列に配置するハンドルの数を返します。

CPSFUNC_GET_PAGECOUNT

CPSFUNC_GET_PAGECOUNT関数コードにより、ComPropSheet 関数は、指定されたグループ親ハンドルの子ページであるプロパティ シート ページの数を返します。

パラメーター (CPSFUNC_GET_PAGECOUNT)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して子ページ数を返すときに、この関数コード パラメーターを CPSFUNC_GET_PAGECOUNT に設定します

  • lParam1: 使用されていません。0 にする必要があります

  • lParam2: 使用されていません。0 にする必要があります

戻り値 (CPSFUNC_GET_PAGECOUNT)

ComPropSheet 関数は、カウントされたページ数を返します。

CPSFUNC_GET_PFNPROPSHEETUI_ICON

CPSFUNC_GET_PFNPROPSHEETUI_ICON関数コードにより、ComPropSheet 関数は、プロパティ シート ページのセットに関連付けられているアイコンへのハンドルを返します。 ページのセットは、PFNPROPSHEETUI 型の関数によって以前に作成されている必要があります。

ComPropSheet 関数は、指定したページ ハンドルに関連付けられている PFNPROPSHEETUI 型の関数を呼び出し、理由値PROPSHEETUI_REASON_GET_ICON渡します。 PFNPROPSHEETUI 型の関数は LoadImage を呼び出し、アイコン リソースを読み込むための bylParam2 で指定されたアイコン サイズを提供します。

パラメーター (CPSFUNC_GET_PFNPROPSHEETUI_ICON)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheetを呼び出してプロパティ シート ページのセットに関連付けられているアイコンへのハンドルを取得するときに、この関数コード パラメーターを CPSFUNC_GET_PFNPROPSHEETUI_ICON に設定します

  • lParam1: プロパティ シート ページのセットを参照する CPSUI ハンドル。 このハンドルは、CPSFUNC_ADD_PFNPROPSHEETUI関数コードを使用した ComPropSheet の呼び出しによって以前に取得されている必要があります。

  • lParam2: アイコンのサイズを表す 2 つの WORD サイズの値をピクセル単位で指定します。 LOWORD 値は幅、HIWORD 値は高さです。 これらの値が 0 の場合は、システム メトリックSM_CXICONとSM_CYICONが使用されます。 詳細については、「 GetSystemMetrics」を参照してください。

戻り値 (CPSFUNC_GET_PFNPROPSHEETUI_ICON)

操作が成功した場合、 ComPropSheet 関数はアイコン ハンドルを返します。それ以外の場合は NULL を返します。

CPSFUNC_IGNORE_CPSUI_PSN_APPLY

CPSFUNC_IGNORE_CPSUI_PSN_APPLY関数コードにより、comPropSheet 関数は、CPSUI のPSN_APPLY通知メッセージの処理を無効または再有効化します。

ユーザーがプロパティ シートの [OK] または [キャンセル] ボタンを選択すると、PSN_APPLY通知メッセージが CPSUI に送信されます。 CPSUI は、アプリケーションの_CPSUICALLBACK型コールバック関数に CPSUICB_REASON_APPLYNOW 理由を提供することで、このメッセージに応答します。

CPSUI によるPSN_APPLY通知メッセージの処理を無効にする場合は、CPSFUNC_DO_APPLY_CPSUI関数コードを使用して、 PSN_APPLY メッセージの配信をシミュレートする必要があります。 それ以外の場合は、プロパティ シート ページに対するユーザーの変更を取得できません。

CPSFUNC_IGNORE_CPSUI_PSN_APPLY関数コードを使用しない場合、CPSUI によるPSN_APPLY通知メッセージの処理は既定で有効になります。

パラメーター (CPSFUNC_IGNORE_CPSUI_PSN_APPLY)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、comPropSheet を呼び出して CPSUI のPSN_APPLY通知メッセージの処理を無効または再有効化するときに、この関数コード パラメーターを CPSFUNC_IGNORE_CPSUI_PSN_APPLY に設定します

  • lParam1: 1 つ以上のプロパティ シート ページのセットを参照する CPSUI ハンドル。 このハンドルは、CPSFUNC_ADD_PCOMPROPSHEETUIの関数コードを使用した ComPropSheet の呼び出し、または CPSFUNC_INSERT_PSUIPAGE の関数コードと挿入型のPSUIPAGEINSERT_PROPSHEETPAGEによって以前に取得されている必要があります。

  • lParam2: 0 以外の値を指定すると、 CPSUI によるCPSUICB_REASON_APPLYNOW 理由の配信が無効になります。 0 の値を指定すると、 CPSUICB_REASON_APPLYNOW 理由の配信が再び可能になります。

戻り値 (CPSFUNC_IGNORE_CPSUI_PSN_APPLY)

操作が成功した場合、 ComPropSheet 関数は 0 以外の値を返します。それ以外の場合は 0 を返します。

CPSFUNC_INSERT_PSUIPAGE

CPSFUNC_INSERT_PSUIPAGE関数コードにより、ComPropSheet 関数はプロパティ シート ページのセットを特定の位置に挿入します。

パラメーター (CPSFUNC_INSERT_PSUIPAGE)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheetを呼び出してプロパティ シート ページのセットを特定の位置に挿入するときに、この関数コード パラメーターを CPSFUNC_INSERT_PSUIPAGE に設定します

  • lParam1: 1 つ以上のプロパティ シート ページのセットへのハンドルを指定します。 新しいページは、lParam2 が指すINSERTPSUIPAGE_INFO構造体の Mode メンバーに応じて、これらのページの前後に挿入されます。 このハンドルは、次のいずれかの関数コードを使用して ComPropSheet を呼び出すことによって以前に取得されている必要があります。

    • CPSFUNC_ADD_HPROPSHEETPAGE

    • CPSFUNC_ADD_PCOMPROPSHEETUI

    • CPSFUNC_ADD_PFNPROPSHEETUI

    • CPSFUNC_ADD_PROPSHEETPAGE

    • CPSFUNC_INSERT_PSUIPAGE

  • lParam2: 新しいページを挿入する場所と方法を説明する、 INSERTPSUIPAGE_INFO 構造体へのポインター

戻り値 (CPSFUNC_INSERT_PSUIPAGE)

操作が成功した場合、 ComPropSheet 関数は、挿入されたページのセットへのハンドルを返します。それ以外の場合、関数は NULL を返します。

CPSFUNC_LOAD_CPSUI_ICON

CPSFUNC_LOAD_CPSUI_ICON関数コードにより、ComPropSheet 関数は CPSUI 指定のアイコン リソースを読み込みます。

CPSUI は LoadImage を呼び出して、指定したアイコン リソースを読み込みます。

パラメーター (CPSFUNC_LOAD_CPSUI_ICON)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して CPSUI 指定のアイコン リソースを読み込むときに、この関数コード パラメーターを CPSFUNC_LOAD_CPSUI_ICON に設定します

  • lParam1: 読み込まれる CPSUI 指定のアイコンのリソース識別子。 これは、Compstui.h で定義されているIDI_CPSUIプレフィックス付き識別子である必要があります。

  • lParam2: アイコンのサイズを表す 2 つの WORD サイズの値をピクセル単位で指定します。 LOWORD 値は幅、HIWORD 値は高さです。 これらの値が 0 の場合は、システム メトリックSM_CXICONとSM_CYICONが使用されます。 詳細については、「GetSystemMetrics」を参照してください。

戻り値 (CPSFUNC_LOAD_CPSUI_ICON)

操作が成功した場合、 ComPropSheet 関数はアイコン ハンドルを返します。それ以外の場合は NULL を返します。

CPSFUNC_LOAD_CPSUI_STRING

CPSFUNC_LOAD_CPSUI_STRING関数コードにより、ComPropSheet 関数は CPSUI 指定の文字列リソースを読み込みます。

ComPropSheet 関数は、LoadString](/windows/win32/api/winuser/nf-winuser-loadstringw) 関数を呼び出して、指定した文字列を読み込みます。

パラメーター (CPSFUNC_LOAD_CPSUI_STRING)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して CPSUI 指定の文字列リソースを読み込むときに、この関数コード パラメーターを CPSFUNC_LOAD_CPSUI_STRING に設定します

  • lParam1: 呼び出し元によって割り当てられたバッファーへの LPSTR 型ポインター。このポインターに対して、HIWORD(lParam2) で指定された CPSUI 指定の文字列が配置されます。

  • lParam2: 次の 2 つの呼び出し元から指定された値が含まれています。

    • LOWORD(lParam2)。 lParam1 が指すバッファーのサイズ (バイト単位)。

    • HIWORD(lParam2)。 読み込まれる CPSUI 指定の文字列のリソース識別子。 これは、Compstui.h で定義されているIDS_CPSUIプレフィックス付き識別子である必要があります。

戻り値 (CPSFUNC_LOAD_CPSUI_STRING)

操作が成功した場合、 ComPropSheet 関数は文字列の長さを返します。 無効なリソース識別子が指定されている場合、関数は 0 を返します。 lParam1 が NULL または LOWORD(lParam2) が 0 の場合、関数は -1 を返します。

CPSFUNC_QUERY_DATABLOCK

CPSFUNC_QUERY_DATABLOCK関数コードにより、comPropSheet 関数は、CPSFUNC_SET_DATABLOCK関数コードを使用して以前に格納されていた呼び出し元から指定されたデータ ブロックを取得します。

通常、この関数コードは、現在のページが非アクティブになる前に別のページに関連付けられている値を取得するために、_CPSUICALLBACK型のコールバック関数 (関数の CPSUICBPARAM 構造体に CPSUICB_REASON_SETACTIVE の Reason 値が含まれている場合) によって使用されます。

パラメーター (CPSFUNC_QUERY_DATABLOCK)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して呼び出し元から指定されたデータ ブロックを取得するときに、この関数コード パラメーターを CPSFUNC_QUERY_DATABLOCK に設定します

  • lParam1: 要求されたデータ ブロックを受信するバッファーのサイズと場所を識別する CPSUIDATABLOCK 構造体へのポインター

  • lParam2: DWORD サイズの識別子値。要求された CPSUIDATABLOCK 構造体を識別するために使用されます。 この値は、CPSFUNC_SET_DATABLOCK関数コードを使用した ComPropSheet の以前の呼び出しで指定されている必要があります。

戻り値 (CPSFUNC_QUERY_DATABLOCK)

操作が成功した場合、 ComPropSheet 関数は、取得したデータ ブロックのサイズを表す値を返します。 lParam1 が NULL の場合、または指定された CPSUIDATABLOCK 構造体のメンバーの値が 0 の場合、ComPropSheet はデータ ブロックを格納するために必要なサイズを返します。 エラーが発生した場合、関数は 0 以下の値を返します。

CPSFUNC_SET_DATABLOCK

CPSFUNC_SET_DATABLOCK関数コードにより、ComPropSheet 関数は呼び出し元から提供されたデータ ブロックを格納します。 この関数コードを使用して、プロパティ シート ページに関する情報を他のページで使用できるようにします。

通常、この関数コードは、非アクティブになる前にページに関連付けられている値を保存するために、_CPSUICALLBACK型指定のコールバック関数 (関数の CPSUICBPARAM 構造体に CPSUICB_REASON_KILLACTIVE の Reason 値が含まれている場合) によって使用されます。

パラメーター (CPSFUNC_SET_DATABLOCK)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、呼び出し元が指定したデータ ブロックを格納するために ComPropSheet を呼び出すときに、この関数コード パラメーターをCPSFUNC_SET_DATABLOCKに設定します

  • lParam1: 格納するデータ ブロックを記述する CPSUIDATABLOCK 構造体へのポインター

  • lParam2: 呼び出し元定義の DWORD サイズの識別子値。 これは、CPSFUNC_QUERY_DATABLOCK関数コードを使用して、ComPropSheet の後続の呼び出しで指定された CPSUIDATABLOCK 構造体を識別するために使用されます。

戻り値 (CPSFUNC_SET_DATABLOCK)

操作が成功した場合、 ComPropSheet 関数は、格納されたバイト数を表す値を返します。それ以外の場合は、0 以下の値を返します。

CPSFUNC_SET_DMPUB_HIDEBITS

CPSFUNC_SET_DMPUB_HIDEBITS関数コードを使用すると、指定したドキュメント プロパティ オプションのセットが表示されないように、ComPropSheet 関数が "非表示" になります。

CPSFUNC_SET_DMPUB_HIDEBITS関数コードは、1 つ以上のドキュメント プロパティ シート オプションに OPTITEM 構造体を定義する場合に、オプションをユーザーが変更できない場合に使用できます。 プロパティ シート ページは COMPROPSHEETUI 構造体を使用して定義する必要があり、構造体の pDlgPage メンバーは CPSUI_PDLGPAGE_DOCPROP または CPSUI_PDLGPAGE_ADVDOCPROPする必要があります。

CPSFUNC_SET_DMPUB_HIDEBITS関数コードを使用する場合は、CPSFUNC_ADD_PCOMPROPSHEETUIまたはCPSFUNC_INSERT_PSUIPAGE関数コードを使用してページを作成する前に、そのコードを ComPropSheet に指定する必要があります。

パラメーター (CPSFUNC_SET_DMPUB_HIDEBITS)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、指定したドキュメント プロパティ オプションの セットを " 非表示" するために ComPropSheet を呼び出すときに、この関数コード パラメーターをCPSFUNC_SET_DMPUB_HIDEBITSに設定します

  • lParam1: 非表示にするオプションを示すビット配列へのポインター。 この配列は 、MAKE_DMPUB_HIDEBIT(DMPub) マクロを使用して作成する必要があります。ここで、DMPub は、1 つ以上のDMPUB_プレフィックス付き定数の OR の組み合わせです。 DMPUB_プレフィックス付き定数は、 OPTITEM 構造体の説明に記載されています。 マクロと定数は Compstui.h で定義されています。

  • lParam2: 使用せず、0 にする必要があります

戻り値 (CPSFUNC_SET_DMPUB_HIDEBITS)

操作が成功した場合、 ComPropSheet 関数は lParam1 に指定された値を返します。それ以外の場合は 0 を返します。

CPSFUNC_SET_FUSION_CONTEXT

CPSFUNC_SET_FUSION_CONTEXTは、指定したページの Fusion アクティブ化コンテキストを設定します。

ページが作成または挿入されようとしていて、 PROPSHEETPAGE 構造体にアクティブ化コンテキストを指定しない場合、親のページアクティブ化コンテキストで作成されます。

親のアクティブ化コンテキストが設定されていない場合、Compstui.dll は親の親を検索し、最上位の親に達するか、アクティブ化コンテキストが正しく設定された親が見つかるまで続けます。

どの親にもアクティブ化コンテキストが設定されていない場合、 Compstui.dll は PROPSHEETPAGE 構造体でアクティブ化コンテキストを指定しません。 つまり、 ページは PropertySheet 関数の呼び出し元のアクティブ化コンテキストで作成されます。

パラメーター (CPSFUNC_SET_FUSION_CONTEXT)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出して指定したページの Fusion アクティブ化コンテキストを設定するときに、この関数コード パラメーターをCPSFUNC_SET_FUSION_CONTEXTに設定します

  • lParam1: Fusion コンテキストへのハンドルを指定します。 Compstui.dll はハンドルを複製し、内部構造に取り付け、呼び出し元がハンドルを保持する義務を負いません。 Compstui.dll ハンドルが削除されたときに、渡されたコンテキスト ハンドルを解放 Compstui.dll。

  • lParam2: 使用せず、0 にする必要があります

戻り値 (CPSFUNC_SET_FUSION_CONTEXT)

操作が成功した場合、 ComPropSheet 関数は 0 より大きい値を返します。 それ以外の場合、 ComPropSheet は 0 以下の値を返します。 エラーの詳細については、 GetLastError 関数を使用します。

CPSFUNC_SET_HSTARTPAGE

CPSFUNC_SET_HSTARTPAGE関数コードにより、ComPropSheet 関数は、指定したプロパティ シート ページを関連付けられたプロパティ シートのトップ ページとしてマークします。 プロパティ シートが現在表示されている場合は、指定したページがアクティブなページになります。

パラメーター (CPSFUNC_SET_HSTARTPAGE)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、指定したプロパティ シート ページを関連付 けられたプロパティ シートのトップ ページとしてマークするために ComPropSheet を呼び出すときに、この関数コード パラメーターをCPSFUNC_SET_HSTARTPAGEに設定します

  • lParam1: 呼び出し元が指定した CPSUI ページ ハンドル。以前は、次のいずれかの関数コードを使用して ComPropSheet を呼び出すことによって取得されます。

    • CPSFUNC_ADD_HPROPSHEETPAGE

    • CPSFUNC_ADD_PCOMPROPSHEETUI

    • CPSFUNC_ADD_PFNPROPSHEETUI

    • CPSFUNC_ADD_PROPSHEETPAGE

    • CPSFUNC_INSERT_PSUIPAGE

    ハンドルが hComPropSheet で指定されたグループに属する単一ページを表す場合、CPSUI はこのページをトップ ページにします。

    ハンドルがグループの親ハンドルを表す場合 ( CPSFUNC_INSERT_PSUIPAGE参照)、 lParam2 はグループのページへの 0 から始まるインデックスを表し、インデックスによって表されるページがトップ ページになります。

  • lParam2: lParam1 がグループの親ハンドルを表す場合、この呼び出し元から指定された値は、グループのページへの 0 から始まるインデックスです。 lParam1hComPropSheet で指定されたグループに属する単一ページを表す場合、このパラメーターは使用されません。 lParam1 で指定されたハンドルがCPSFUNC_ADD_PCOMPROPSHEETUI関数コードを使用して取得され、関連付けられている COMPROPSHEETUI 構造体の pDlgPage メンバーがCPSUI_PDLGPAGE_DOCPROPに設定されている場合は、lParam2 に次のいずれかの値を指定できます。

    • SSP_STDPAGE1 - [レイアウト] ページをトップ ページにします。

    • SSP_STDPAGE2 - 用紙/品質ページをトップ ページにします。

    • SSP_TVPAGE - [詳細設定] ページをトップ ページにします。

戻り値 (CPSFUNC_SET_HSTARTPAGE)

操作が成功した場合、 ComPropSheet 関数は lParam1 に指定された値を返します。それ以外の場合は 0 を返します。

CPSFUNC_SET_PSUIPAGE_ICON

CPSFUNC_SET_PSUIPAGE_ICON関数コードにより、ComPropSheet 関数はプロパティ シート ページのタブに割り当てられているアイコンを追加、置換、または削除します。

lParam2 にアイコン ハンドルが含まれており、lParam1 で指定されたページが現在表示されている場合、CPSUI は指定したページのタブにアイコンを追加します。アイコンが既にページに割り当てられている場合、古いアイコンは新しいアイコンに置き換えられます。 lParam2 が 0 の場合、現在のアイコン (存在する場合) は削除されます。

CPSFUNC_SET_PSUIPAGE_ICON関数コードで指定されたすべてのアイコンについて、CPSUI はイメージ サイズを 16 x 16 ピクセルに設定します。

アイコン ハンドルは 、LoadImage を呼び出して取得する必要があります。

パラメーター (CPSFUNC_SET_PSUIPAGE_ICON)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheetを呼び出してプロパティ シート ページのタブに割り当てられたアイコンを追加、置換、または削除するときに、この関数コード パラメーターをCPSFUNC_SET_PSUIPAGE_ICONに設定します

  • lParam1: 呼び出し元が指定した CPSUI ページ ハンドル。以前は、次のいずれかの関数コードを使用して ComPropSheet を呼び出すことによって取得されます。

    • CPSFUNC_ADD_HPROPSHEETPAGE

    • CPSFUNC_ADD_PROPSHEETPAGE

    • CPSFUNC_INSERT_PSUIPAGE ( INSERTPSUIPAGE_INFO 構造体の Type メンバーを PSUIPAGEINSERT_HPROPSHEETPAGE または PSUIPAGEINSERT_PROPSHEETPAGE に設定)

  • lParam2: 呼び出し元が指定したアイコン ハンドル。 このパラメーターを 0 に設定すると、現在のアイコンを削除できます

戻り値 (CPSFUNC_SET_PSUIPAGE_ICON)

操作が成功した場合、 ComPropSheet 関数は 1 を返します。 エラーが発生した場合、または指定したページが現在表示されていない場合、関数は 0 を返します。

CPSFUNC_SET_PSUIPAGE_TITLE

CPSFUNC_SET_PSUIPAGE_TITLE関数コードにより、ComPropSheet 関数はプロパティ シート ページのタブ タイトルを設定します。

パラメーター (CPSFUNC_SET_PSUIPAGE_TITLE)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、ComPropSheet を呼び出してプロパティ シート ページのタブ タイトルを設定するときに、この関数コード パラメーターをCPSFUNC_SET_PSUIPAGE_TITLEに設定します

  • lParam1: 呼び出し元が指定した CPSUI ページ ハンドル。以前は、次のいずれかの関数コードを使用して ComPropSheet を呼び出すことによって取得されます。

    • CPSFUNC_ADD_HPROPSHEETPAGE

    • CPSFUNC_ADD_PROPSHEETPAGE

    • CPSFUNC_INSERT_PSUIPAGE ( INSERTPSUIPAGE_INFO 構造体の Type メンバーが PSUIPAGEINSERT_HPROPSHEETPAGE またはPSUIPAGEINSERT_PROPSHEETPAGE に設定されています)。

  • lParam2: 新しいタイトルを指定する NULL で終わる文字列への呼び出し元指定ポインター

戻り値 (CPSFUNC_SET_PSUIPAGE_TITLE)

操作が成功した場合、 ComPropSheet 関数は 1 を返します。 エラーが発生した場合、または指定したページが現在表示されていない場合、関数は 0 を返します。

CPSFUNC_SET_RESULT

CPSFUNC_SET_RESULT関数コードにより、ComPropSheet 関数は、指定したページとその親に関連付けられているすべての PFNPROPSHEETUI 型の関数に、指定した結果値を渡します。

結果の値を設定する方法の詳細については、 SETRESULT_INFO 構造体の説明を参照してください。

次の注意は、カスタム UI プロパティ シートを含む Unidrv または Pscript5 ベースの IHV UI プラグインに適用され、プロパティ シートで行われるユーザー設定は永続的である必要があります。 プラグインで Function パラメーターを CPSFUNC_SET_RESULT に設定して ComPropSheet 関数を呼び出す場合、プラグインは lParam2 パラメーターを CPSUI_OK に設定する必要があります。

パラメーター (CPSFUNC_SET_RESULT)
  • hComPropSheet: グループの親ハンドル

  • 関数: 呼び出し元は、指定したページとその 親に関連付 けられているすべての PFNPROPSHEETUI 型の関数に指定した結果値を渡すために ComPropSheet を呼び出すときに、この関数コード パラメーターをCPSFUNC_SET_RESULTに設定します。

  • lParam1: 結果値が渡されるページへの呼び出し元指定の CPSUI ハンドル。 lParam1 が NULL の場合、CPSUI は hComPropSheet で指定された値を使用します。

  • lParam2: 呼び出し元が指定した 32 ビット DWORD 結果値。

戻り値 (CPSFUNC_SET_RESULT)

操作が成功した場合、 ComPropSheet 関数は、呼び出された PFNPROPSHEETUI 型の関数の数を返します。 lParam1 に指定されたハンドルが無効な場合、関数は -1 を返します。

要件

要件
対象プラットフォーム デスクトップ
Header compstui.h (Compstui.h を含む)