PAGESETUPDLGW 構造体 (commdlg.h)

PageSetupDlg 関数が [ページ設定] ダイアログ ボックスの初期化に使用する情報を格納します。 ユーザーがダイアログ ボックスを閉じると、この構造体のユーザー定義ページ パラメーターに関する情報が返されます。

構文

typedef struct tagPSDW {
  DWORD           lStructSize;
  HWND            hwndOwner;
  HGLOBAL         hDevMode;
  HGLOBAL         hDevNames;
  DWORD           Flags;
  POINT           ptPaperSize;
  RECT            rtMinMargin;
  RECT            rtMargin;
  HINSTANCE       hInstance;
  LPARAM          lCustData;
  LPPAGESETUPHOOK lpfnPageSetupHook;
  LPPAGEPAINTHOOK lpfnPagePaintHook;
  LPCWSTR         lpPageSetupTemplateName;
  HGLOBAL         hPageSetupTemplate;
} PAGESETUPDLGW, *LPPAGESETUPDLGW;

メンバー

lStructSize

型: DWORD

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

hwndOwner

型: HWND

ダイアログ ボックスを所有するウィンドウへのハンドル。 このメンバーは、任意の有効なウィンドウ ハンドルにすることも、ダイアログ ボックスに所有者がない場合は NULL にすることもできます。

hDevMode

種類: HGLOBAL

DEVMODE 構造体を含むグローバル メモリ オブジェクトへのハンドル。 入力時にハンドルが指定されている場合、対応する DEVMODE 構造体の値を使用して、ダイアログ ボックス内のコントロールを初期化します。 出力時に、ダイアログ ボックスは hDevMode をグローバル メモリ ハンドルに設定し、ユーザーの選択を指定する値を含む DEVMODE 構造体に設定します。 ユーザーの選択が使用できない場合、ダイアログ ボックスは hDevMode を NULL に設定します。

hDevNames

種類: HGLOBAL

DEVNAMES 構造体を含むグローバル メモリ オブジェクトへのハンドル。 この構造体には、ドライバー名、プリンター名、および出力ポート名を指定する 3 つの文字列が含まれています。 入力時にハンドルが指定されている場合、対応する DEVNAMES 構造体の文字列を使用して、ダイアログ ボックス内のコントロールを初期化します。 出力時に、ダイアログ ボックスは hDevNames をグローバル メモリ ハンドルに設定し、ユーザーの選択を指定する文字列を含む DEVNAMES 構造体に設定します。 ユーザーが選択できない場合、ダイアログ ボックスは hDevNames を NULL に設定します。

Flags

型: DWORD

[ ページ設定 ] ダイアログ ボックスの初期化に使用できるビット フラグのセット。 ダイアログ ボックスが返されると、ユーザーの入力を示すようにこれらのフラグが設定されます。 このメンバーには、次の値の 1 つ以上を指定できます。

ptPaperSize

種類: POINT

ユーザーが選択した用紙の寸法。 PSD_INTHOUSANDTHSOFINCHES または PSD_INHUNDREDTHSOFMILLIMETERS フラグは、測定単位を示します。

rtMinMargin

種類: RECT

左余白、上余白、右余白、および下余白の最小許容幅。 PSD_MINMARGINS フラグが設定されていない場合、システムはこのメンバーを無視します。 これらの値は、 rtMargin メンバーで指定された値以下である必要があります。 PSD_INTHOUSANDTHSOFINCHES または PSD_INHUNDREDTHSOFMILLIMETERS フラグは、測定単位を示します。

rtMargin

種類: RECT

左余白、上余白、右余白、および下余白の幅。 PSD_MARGINS フラグを設定した場合、rtMargin は初期余白の値を指定します。 PageSetupDlg が返されると、rtMargin にはユーザーが選択した余白幅が含まれます。 PSD_INHUNDREDTHSOFMILLIMETERS または PSD_INTHOUSANDTHSOFINCHES フラグは、測定単位を示します。

hInstance

種類: HINSTANCE

PSD_ENABLEPAGESETUPTEMPLATE フラグが Flags メンバーに設定されている場合、hInstance は lpPageSetupTemplateName メンバーによって名前付けされたダイアログ ボックス テンプレートを含むアプリケーションまたはモジュール インスタンスへのハンドルです。

lCustData

型: LPARAM

システムが lpfnPageSetupHook メンバーによって識別されるフック プロシージャに渡すアプリケーション定義データ。 システムが WM_INITDIALOG メッセージをフック プロシージャに送信すると、メッセージの lParam パラメーターは、ダイアログの作成時に指定された PAGESETUPDLG 構造体へのポインターです。 フック プロシージャでは、このポインターを使用して lCustData 値を取得できます。

lpfnPageSetupHook

種類: LPPAGESETUPHOOK

ダイアログ ボックス用のメッセージを処理できる PageSetupHook フック プロシージャへのポインター。 flags メンバーで PSD_ENABLEPAGESETUPHOOK フラグが設定されていない限 り、この メンバーは無視されます。

lpfnPagePaintHook

種類: LPPAGEPAINTHOOK

サンプル ページが再描画されるたびにダイアログ ボックスからWM_PSD_* メッセージを受信する PagePaintHook フック プロシージャへのポインター。 メッセージを処理することで、フック プロシージャはサンプル ページの外観をカスタマイズできます。 flags メンバーで PSD_ENABLEPAGEPAINTHOOK フラグが設定されていない限 り、この メンバーは無視されます。

lpPageSetupTemplateName

型: LPCTSTR

hInstance メンバーによって識別されるモジュール内のダイアログ ボックス テンプレート リソースの名前。 このテンプレートは、標準のダイアログ ボックス テンプレートの代わりに使用されます。 番号付きダイアログ ボックス リソースの場合、 lpPageSetupTemplateName には MAKEINTRESOURCE マクロによって返される値を指定できます。 flags メンバーでPSD_ENABLEPAGESETUPTEMPLATE フラグが設定されていない限り、このメンバーは無視されます。

hPageSetupTemplate

種類: HGLOBAL

PSD_ENABLEPAGESETUPTEMPLATEHANDLE フラグが Flags メンバーで設定されている場合、hPageSetupTemplate はダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。

注釈

PSD_INHUNDREDTHSOFMILLIMETERSフラグとPSD_INTHOUSANDTHSOFINCHESフラグが指定されていない場合、システムは既定のユーザー ロケールのLOCALE_IMEASURE値を照会して、余白の幅と用紙サイズの測定単位 (100 分の 1 ミリメートルまたは 1000 分の 1 インチ) を決定します。

hDevNames と hDevMode の両方に有効なハンドルがあり、DEVNAMES 構造体の wDeviceOffset メンバーで指定されたプリンター名が DEVMODE 構造体の dmDeviceName メンバーによって指定された名前と同じでない場合、システムは既定で wDeviceOffset で指定された名前を使用します。

要件

こちらもご覧ください

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

概念

Devmode

DEVNAMES

MAKEINTRESOURCE

その他のリソース

PagePaintHook

PageSetupDlg

PageSetupHook

リファレンス

WM_INITDIALOG