ユーザーが保存するファイル名を指定するための「保存」ダイアログボックスを作成します。
BOOL GetSaveFileNameA(
LPOPENFILENAME pofn
);
COMDLG32.DLL
ダイアログボックスを初期化するために使用されるOPENFILENAME構造体のアドレスを指定します。関数から制御が返ると、ユーザーが選択したファイルに関する情報が格納されます。
ユーザーがファイル名を指定して「OK」ボタンを押すと、戻り値は0以外の値になります。OPENFILENAME構造体のlpstrFileメンバが指すバッファに、ユーザーが選択したファイルのフルパスとファイル名が格納されます。
ユーザーがダイアログボックをキャンセルまたは閉じた場合、もしくはエラーが発生した場合には、戻り値は0になります。拡張エラー情報を取得するには、CommDlgExtendedError関数を使います。この関数は以下のいずれかの値を返します。
エクスプローラスタイルの「開く」ダイアログボックスは、Windowsエクスプローラに似たユーザーインターフェースの特徴を持ちます。このダイアログボックスでは、OFNHookProcフックプロシージャを実装できます。フックプロシージャを有効にするには、OPENFILENAME構造体のFlagsメンバにOFN_EXPLORERおよびOFN_ENABLEHOOKフラグを指定し、lpfnHookメンバにフックプロシージャのアドレスを指定します。
Windowsでは引き続きオールドスタイルの「開く」ダイアログボックスをサポートします。オールドスタイルダイアログボックスを表示するには、OFNHookProcOldStyleフックプロシージャを有効にし、OFN_EXPLORERフラグを設定しないようにします。
Windows 95 以降 / Windows NT 3.1 以降