<Return[PQ]><Top>

PrintDlgEx

Declare Function Api_PrintDlgEx& Lib "comdlg32" Alias "PrintDlgExA" (ByRef TLPPRINTDLGEXA As PRINTDLGEXA)

Declare Function PrintDlgEx Lib "comdlg32" Alias "PrintDlgExA" (ByRef TLPPRINTDLGEXA As PRINTDLGEXA) As Long

ユーザーが特定の印刷ジョブのプロパティを指定する［印刷］プロパティシートを表示する。［印刷］プロパティシートには、［印刷］コモンダイアログボックスに似たコントロールを含む［一般］ページがある。［一般］ページの後ろに、アプリケーション固有のプロパティページ、ドライバ固有のプロパティページを追加できる。

パラメータ
lppd
    プロパティシートの初期化に使う情報が入った PRINTDLGEX 構造体へのポインタを指定する。

    PrintDlgEX 関数から戻ると、この構造体にユーザーの選択に関する情報が格納される。


戻り値
    関数が成功すると、S_OK が返り、PRINTDLGEX 構造体の dwResultAction メンバが次のいずれかの値に設定される。

    値                                 

意味                                                                                                                                        

    PD_RESULT_APPLY

　

　

ユーザーが［適用］ボタンを選択し、その後で［キャンセル］ボタンをクリックした。

これは、ユーザーはプロパティシートへの変更を適用したいが、まだ印刷したくないことを示す。

PRINTDLGEX 構造体には、ユーザーが［適用］ボタンをクリックしたときに指定していた情報が入っている。

    PD_RESULT_CANCEL

ユーザーが［キャンセル］ボタンをクリックした。PRINTDLGEX 構造体に入っている情報は変更されない。

    PD_RESULT_PRINT

　

ユーザーが［印刷］ボタンをクリックした。

PRINTDLGEX 構造体には、ユーザーが指定した情報が入っている。

    関数が失敗すると、次のいずれかの COM エラーコードが返る。

    値                                 

意味                                                                                                                                        

    E_OUTOFMEMORY

メモリが不足している。

    E_INVALIDARG

1 つ以上の引数が無効である。

    E_POINTER

無効なポインタである。

    E_HANDLE

無効なハンドルである。

    E_FAIL

定義されていないエラーが発生した。