PRINTDLGEXA 構造体 (commdlg.h)

PrintDlgEx 関数が Print プロパティ シートの初期化に使用する情報を格納します。 ユーザーがプロパティ シートを閉じると、システムはこの構造体を使用して、ユーザーの選択に関する情報を返します。

構文

typedef struct tagPDEXA {
  DWORD            lStructSize;
  HWND             hwndOwner;
  HGLOBAL          hDevMode;
  HGLOBAL          hDevNames;
  HDC              hDC;
  DWORD            Flags;
  DWORD            Flags2;
  DWORD            ExclusionFlags;
  DWORD            nPageRanges;
  DWORD            nMaxPageRanges;
  LPPRINTPAGERANGE lpPageRanges;
  DWORD            nMinPage;
  DWORD            nMaxPage;
  DWORD            nCopies;
  HINSTANCE        hInstance;
  LPCSTR           lpPrintTemplateName;
  LPUNKNOWN        lpCallback;
  DWORD            nPropertyPages;
  HPROPSHEETPAGE   *lphPropertyPages;
  DWORD            nStartPage;
  DWORD            dwResultAction;
} PRINTDLGEXA, *LPPRINTDLGEXA;

メンバー

lStructSize

型: DWORD

構造体のサイズ (バイト単位)。

hwndOwner

型: HWND

プロパティ シートを所有するウィンドウへのハンドル。 このメンバーは、有効なウィンドウ ハンドルである必要があります。 NULL にすることはできません。

hDevMode

種類: HGLOBAL

DEVMODE 構造体を含む移動可能なグローバル メモリ オブジェクトへのハンドル。 入力時に hDevMode が NULL でない場合は、DEVMODE 構造体に移動可能なメモリ ブロックを割り当て、そのメンバーを初期化する必要があります。 PrintDlgEx 関数は、入力データを使用してプロパティ シート内のコントロールを初期化します。 PrintDlgEx が返されると、DEVMODE メンバーはユーザーの入力を示します。

入力時に hDevMode が NULL の場合、PrintDlgEx は DEVMODE 構造体にメモリを割り当て、そのメンバーを初期化してユーザーの入力を示し、それを識別するハンドルを返します。

hDevMode メンバーと hDevNames メンバーの詳細については、このトピックの最後にある「解説」セクションを参照してください。

hDevNames

種類: HGLOBAL

DEVNAMES 構造体を含む移動可能なグローバル メモリ オブジェクトへのハンドル。 入力時に hDevNames が NULL でない場合は、DEVNAMES 構造体に移動可能なメモリ ブロックを割り当て、そのメンバーを初期化する必要があります。 PrintDlgEx 関数は、入力データを使用してプロパティ シート内のコントロールを初期化します。 PrintDlgEx が返されると、DEVNAMES メンバーには、ユーザーが選択したプリンターの情報が含まれます。 この情報を使用して、デバイス コンテキストまたは情報コンテキストを作成できます。

hDevNames メンバーは NULL にすることができます。この場合、PrintDlgEx は DEVNAMES 構造体にメモリを割り当て、そのメンバーを初期化してユーザーの入力を示し、それを識別するハンドルを返します。

hDevMode メンバーと hDevNames メンバーの詳細については、このトピックの最後にある「解説」セクションを参照してください。

hDC

種類: HDC

Flags メンバーがPD_RETURNDCまたはPC_RETURNICフラグを指定するかどうかに応じて、デバイス コンテキストまたは情報コンテキストへのハンドル。 どちらのフラグも指定されていない場合、このメンバーの値は未定義です。 両方のフラグが指定されている場合、 PD_RETURNDC は優先度を持ちます。 hDC が NULL でない場合は、不要になった GDI オブジェクトを解放するために DeleteDC を呼び出す必要があります。それ以外の場合は、PrintDlgw API を呼び出すたびに GDI オブジェクトがリークします。

Flags

型: DWORD

Print プロパティ シートの初期化に使用できるビット フラグのセット。 PrintDlgEx 関数が返されると、ユーザーの入力を示すようにこれらのフラグが設定されます。 このメンバーには、次の値の 1 つ以上を指定できます。

PrintDlg または PrintDlgEx が DEVMODE 構造体の dmCopies および dmCollate メンバーに正しい値を返すようにするには、TRUEPD_RETURNDC = 設定し、TRUE PD_USEDEVMODECOPIESANDCOLLATE = します。 そのため、PRINTDLG 構造体の nCopies メンバーは常に 1 で、PD_COLLATEは常に FALSE です。

PrintDlg または PrintDlgEx が nCopies とPD_COLLATEで正しい値を返すようにするには、TRUEPD_RETURNDC設定 = し、FALSE をPD_USEDEVMODECOPIESANDCOLLATE = します。 そのため、 dmCopies は常に 1 で、 dmCollate は常に FALSE です。

Windows Vista 以降では、PrintDlg または PrintDlgEx を呼び出し、PD_RETURNDCTRUE に設定し、PD_USEDEVMODECOPIESANDCOLLATEFALSE に設定すると、PrintDlg 関数または PrintDlgEx 関数は PRINTDLG 構造体の nCopies メンバー内のコピー数を設定し、PRINTDLG 構造体の hDC メンバーによって表される構造体内のコピー数を設定します。

GDI の呼び出しを行う場合は、 nCopies の値を無視し、値を 1 と見なし、返された hDC を使用して重複するコピーを印刷しないようにする必要があります。

Flags2

型: DWORD

ExclusionFlags

型: DWORD

Print プロパティ シートのプリンター ドライバー プロパティ ページから項目を除外できるビット フラグのセット。 この値は、 PD_EXCLUSIONFLAGS フラグが Flags メンバーに設定されている場合にのみ使用されます。 除外フラグは、除外する項目が [全般 ] ページまたは Print プロパティ シートのアプリケーション定義ページに含まれる場合にのみ使用する必要があります。 このメンバーは、次のフラグを指定できます。

PD_EXCL_COPIESANDCOLLATE

Print プロパティ シートのプリンター ドライバーのプロパティ ページから、コピーコントロールと Collate コントロールを除外します。 このフラグは、アプリケーションが Print プロパティ シートの [全般] ページの下部で提供される既定の [コピー] コントロールと [Collate] コントロールを使用する場合に常に設定する必要があります。

nPageRanges

型: DWORD

入力時に、このメンバーを lpPageRanges 配列で指定されたページ範囲の初期数に設定します。 PrintDlgEx 関数が戻ると、nPageRanges は lpPageRanges 配列に格納されているユーザー指定のページ範囲の数を示します。 PD_NOPAGENUMS フラグが指定されている場合、この値は無効です。

nMaxPageRanges

型: DWORD

lpPageRanges バッファーの配列要素のサイズ。 この値は、配列に格納できるページ範囲の最大数を示します。 PD_NOPAGENUMS フラグが指定されている場合、この値は無効です。 PD_NOPAGENUMS フラグを指定しない場合、この値は 0 より大きくする必要があります。

lpPageRanges

種類: LPPRINTPAGERANGE

PRINTPAGERANGE 構造体の配列を含むバッファーへのポインター。 入力時に、配列には Pages 編集コントロール に表示する初期ページ範囲が含まれます。 PrintDlgEx 関数が戻るとき、配列にはユーザーが指定したページ範囲が含まれます。 PD_NOPAGENUMS フラグが指定されている場合、この値は無効です。 PD_NOPAGENUMS フラグが指定されていない場合、lpPageRanges は NULL 以外である必要があります。

nMinPage

型: DWORD

Pages 編集コントロールで指定されたページ範囲の最小値。 PD_NOPAGENUMS フラグが指定されている場合、この値は無効です。

nMaxPage

型: DWORD

Pages 編集コントロールで指定されたページ範囲の最大値。 PD_NOPAGENUMS フラグが指定されている場合、この値は無効です。

nCopies

型: DWORD

hDevMode が NULL の場合の Copies 編集コントロールの初期コピー数を格納します。それ以外の場合、DEVMODE 構造体の dmCopies メンバーには初期値が含まれます。 PrintDlgEx が返されると、nCopies には、アプリケーションが印刷する必要がある実際のコピー数が含まれます。 この値は、アプリケーションまたはプリンター ドライバーが複数のコピーの印刷を担当するかどうかによって異なります。 PD_USEDEVMODECOPIESANDCOLLATE フラグが Flags メンバーに設定されている場合、nCopies は戻り値として常に 1 になり、プリンター ドライバーは複数のコピーを印刷します。 フラグが設定されていない場合、アプリケーションは nCopies で指定された部数を印刷する必要があります。 詳細については、 PD_USEDEVMODECOPIESANDCOLLATE フラグの説明を参照してください。

hInstance

種類: HINSTANCE

PD_ENABLEPRINTTEMPLATE フラグが Flags メンバーに設定されている場合、hInstance は lpPrintTemplateName メンバーによって名前付けされたダイアログ ボックス テンプレートを含むアプリケーションまたはモジュール インスタンスへのハンドルです。 PD_ENABLEPRINTTEMPLATEHANDLE フラグが Flags メンバーに設定されている場合、hInstance はダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。 Flags メンバーでどちらのテンプレート フラグも設定されていない場合、hInstance は NULL にする必要があります。

lpPrintTemplateName

型: LPCTSTR

hInstance メンバーによって識別されるモジュール内のダイアログ ボックス テンプレート リソースの名前。 このテンプレートは、[ 全般 ] ページの下部にある既定のダイアログ ボックス テンプレートを置き換えます。 既定のテンプレートには、[ 印刷 ] ダイアログ ボックスと同様のコントロールが含まれています。 PD_ENABLEPRINTTEMPLATE フラグが Flags メンバーに設定されていない限り、このメンバーは無視されます。

lpCallback

種類: LPUNKNOWN

アプリケーション定義のコールバック オブジェクトへのポインター。

オブジェクトには、[全般] ページの下部にある子ダイアログ ボックスのメッセージを受信する IPrintDialogCallback クラスが含まれている必要があります。

コールバック オブジェクトには、IPrintDialogServices インターフェイスへのポインターを受け取る IObjectWithSite クラスも含まれている必要があります。 PrintDlgEx 関数は、IID_IPrintDialogCallbackとIID_IObjectWithSiteの両方についてコールバック オブジェクトで IUnknown::QueryInterface を呼び出して、サポートされているインターフェイスを決定します。

コールバック情報を取得しない場合は、 lpCallback を NULL に設定 します。

nPropertyPages

型: DWORD

lphPropertyPages 配列内のプロパティ ページ ハンドルの数。

lphPropertyPages

種類: HPROPSHEETPAGE*

Print プロパティ シートに追加するプロパティ ページ ハンドルの配列を格納します。 追加のプロパティ ページは、[ 全般] ページの後に表示されます。 これらの追加ページを作成するには、 CreatePropertySheetPage 関数を使用します。 PrintDlgEx 関数が戻ると、lphPropertyPages 配列内のすべての HPROPSHEETPAGE ハンドルが破棄されます。 nPropertyPages が 0 の場合、lphPropertyPages は NULL である必要があります。

nStartPage

型: DWORD

最初に表示されるプロパティ ページ。 [全般] ページを表示するには、START_PAGE_GENERALを指定します。 それ以外の場合は、 lphPropertyPages メンバーで指定された配列内のプロパティ ページの 0 から始まるインデックスを指定します。 一貫性を保つには、[ 全般] ページでプロパティ シートを常に開始することをお勧めします。

dwResultAction

型: DWORD

入力時に、このメンバーを 0 に設定します。 PrintDlgEx 関数がS_OKを返す場合、dwResultAction にはダイアログの結果が含まれます。 PrintDlgEx がエラーを返す場合、このメンバーは無視する必要があります。 dwResultAction メンバーには、次のいずれかの値を指定できます。

PD_RESULT_APPLY

ユーザーが [ 適用 ] ボタンをクリックし、後で [キャンセル ] ボタンをクリックしました。 これは、ユーザーがプロパティ シートで行われた変更を適用したいが、まだ印刷したくないことを示します。 PRINTDLGEX 構造体には、[適用] ボタンがクリックされた時点でユーザーが指定した情報が含まれます。

PD_RESULT_CANCEL

ユーザーが [ キャンセル ] ボタンをクリックしました。 PRINTDLGEX 構造体の情報は変更されません。

PD_RESULT_PRINT

ユーザーが [ 印刷 ] ボタンをクリックしました。 PRINTDLGEX 構造体には、ユーザーが指定した情報が含まれています。

解説

hDevMode と hDevName の両方が NULL の場合、PrintDlgEx は現在の既定のプリンターを使用してプロパティ シートを初期化します。 別のプリンターのプロパティ シートを初期化するには、DEVNAMES 構造体の wDeviceOffset メンバーを使用してプリンターの名前を指定します。

DEVMODE 構造体の dmDeviceName メンバーもプリンター名を指定します。 ただし、 dmDeviceName は 32 文字に制限されており、 wDeviceOffset 名は使用できません。 wDeviceOffset 名と dmDeviceName 名が同じでない場合、PrintDlgEx は wDeviceOffset で指定されたプリンターを使用してプロパティ シートを初期化します。

PD_RETURNDEFAULT フラグが設定され、 hDevMode と hDevName の 両方が NULL の場合、 PrintDlgEx は hDevNames メンバーと hDevMode メンバーを使用して、ダイアログ ボックスを表示せずに現在の既定のプリンターに関する情報を返します。

PrintDlgEx の実行中に、PRINTDLGEX 構造体で指定した DEVMODE および DEVNAMES 構造体に、常に現在のデータが含まれているとは限りません。 このため、初期ページのアプリケーション固有のプロパティ ページと IPrintDialogCallback ルーチンは 、IPrintDialogServices インターフェイスを使用して、現在のプリンターの状態に関する情報を取得する必要があります。

要件

関連項目

共通ダイアログ ボックス ライブラリ

概念

Devmode

DEVNAMES

IPrintDialogCallback

IPrintDialogServices

PrintDlgEx

参照