ファイルを開くコモンダイアログを使う

最終更新 2003 10/09

サンプルのダウンロード → Exp_OpenDialog.lzh(36k)

全ソースコード
#include <windows.h> #include <commdlg.h> //ライブラリを読み込む #pragma comment( lib, "comdlg32.lib" ) //OPENFILENAME 構造体用のフラグ #define OPEN_DIALOG_FLAGS OFN_FILEMUSTEXIST | OFN_HIDEREADONLY | OFN_NOCHANGEDIR | OFN_NONETWORKBUTTON | OFN_PATHMUSTEXIST | OFN_READONLY //ShowOpenDialog 関数の引数に使う構造体 typedef struct tagOpenDialog { char path[ MAX_PATH + MAX_PATH ]; char name[ MAX_PATH ]; LPSTR pDefaultExt; LPSTR pFilter; LPSTR pTitle; int filterIndex; } OPENDIALOG; //プロトタイプ宣言 LRESULT CALLBACK WinProc( HWND, UINT, WPARAM, LPARAM ); BOOL ShowOpenDialog( OPENDIALOG * ); //メイン int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd ) { //ShowOpenDialog の引数で使う構造体を宣言して必要な値をセット OPENDIALOG dialog; dialog.filterIndex = 1; dialog.pDefaultExt = NULL; dialog.pFilter = NULL; dialog.pTitle = "ファイル選択"; //ファイルを開くダイアログボックスを表示 if( ShowOpenDialog( &dialog ) ) { MessageBox( NULL, dialog.path, "選択したファイルのパス", MB_OK ); MessageBox( NULL, dialog.name, "選択したファイル名", MB_OK ); } return 0; } //メッセージの対応 LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam ) { return DefWindowProc( hWnd, uMsg, wParam, lParam ); } /* ShowOpenDialog ファイルを開くコモンダイアログを開く 引数 OPENDIALOG 型の構造体のポインタ。 この関数を呼ぶ前にあらかじめ宣言しておき、必要な値をメンバ関数にセットしておく。 戻り値 ファイルが選択され、正常に終了した = TRUE pOpenDialog の path には選択されたファイルの絶対パスが格納され name には選択されたファイルのパスを含まないファイル名が格納される。 キャンセルボタンが押されたか、正常に終了できなかった = FALSE */ BOOL ShowOpenDialog( OPENDIALOG *pOpenDialog ) { //引数チェック if( pOpenDialog->filterIndex < 1 ) pOpenDialog->filterIndex = 1; if( pOpenDialog->pFilter == NULL ) pOpenDialog->pFilter = "全てのファイル(*.*)\0*.*\0\0"; //ファイル名を受け取るための配列を初期化 ZeroMemory( pOpenDialog->path, sizeof( pOpenDialog->path ) ); ZeroMemory( pOpenDialog->name, sizeof( pOpenDialog->name ) ); //ファイルを開くダイアログの情報をセット OPENFILENAME open; ZeroMemory( &open, sizeof( OPENFILENAME ) ); //念のため０で初期化 open.Flags = OPEN_DIALOG_FLAGS; open.hInstance = NULL; open.hwndOwner = NULL; open.lCustData = 0; open.lpfnHook = 0; open.lpstrCustomFilter = NULL; open.lpstrDefExt = pOpenDialog->pDefaultExt; open.lpstrFile = pOpenDialog->path; open.lpstrFileTitle = pOpenDialog->name; open.lpstrFilter = pOpenDialog->pFilter; open.lpstrInitialDir = NULL; open.lpstrTitle = pOpenDialog->pTitle; open.lpTemplateName = NULL; open.lStructSize = sizeof( OPENFILENAME ); open.nFileExtension = 0; open.nFileOffset = 0; open.nFilterIndex = pOpenDialog->filterIndex; open.nMaxCustFilter = 0; open.nMaxFile = MAX_PATH + MAX_PATH; open.nMaxFileTitle = MAX_PATH; //ファイルを開くダイアログ表示 if( !GetOpenFileName( &open ) ) return FALSE; return TRUE; }

GetOpenFileName 関数
        
    対応しているバージョン
    95, 98, Me, NT3.1以降, CE1.0以降, 2000, XP
            
    必要なヘッダとライブラリ
    commdlg.h
    comdlg32.lib



【必要なこと】


ファイルを開くダイアログボックスを使用するには commdlg.h を
インクルードします。
ライブラリは comdlg32.lib が必要ですが、ＶＣ＋＋の場合は初期状態で
このライブラリを読み込むように設定されているので、設定し直す必要は
ないと思います。
サンプルでは念のため、#pragma comment( lib, "comdlg32.lib" ) と
やって comdlg32.lib を読み込んでいます。
#pragma comment( lib, "ライブラリファイル名" ) と書くと
"ライブラリファイル名" で指定したライブラリを読み込んでくれるので
ＶＣ＋＋のメニューの　[ﾌﾟﾛｼﾞｪｸﾄ(P)] - [設定(S)] - リンク
でライブラリファイルを指定する必要がなくなって便利です。
#pragma comment() の最後に ; をつけないようにしましょう。


【ダイアログボックスの表示】


ファイルを開くダイアログボックスを表示するには GetOpenFileName()
関数を使います。
引数には OPENFILENAME という構造体のポインタを指定するように
なっているので OPENFILENAME ofn; こんな感じで宣言した後、メンバ
変数に必要な情報をセットします。


【ダイアログボックスの設定】


OPENFILENAMEで特に重要なメンバ変数は

lpstrFile          選択されたファイルの絶対パスを格納する
                   配列のポインタ
lpstrFileTitle     選択されたファイルののパスを含まない
                   ファイル名を格納する配列のポインタ
lpstrFilter        選択できるファイルのフィルター
nMaxFile           lpstrFile に格納できる文字数
nMaxFileTitle      lpstrTitle に格納できる文字数
lStructSize        構造体のサイズ

この６つです。
この６つの値を正しく設定しないとダイアログボックスが開いて
くれません。
他のメンバ変数は、必要がなければ変数の型に応じて 0 か NULL を
指定しておけば問題ないと思います。

lpstrFile には、選択されたファイルの絶対パスを格納するための
char 型配列のポインタ（配列の先頭アドレス）を指定します。
この値をセットするまえにあらかじめ

char path[MAX_PATH + MAX_PATH];

というように char 型の配列を宣言しておきます。

配列のサイズは MAX_PATH より大きいサイズを指定します。
ここではとりあえず、MAX_PATH ２つ分のサイズを指定しています。

MAX_PATH はあらかじめ定義されているマクロです。
もともとは stdlib.h に定義されているのですが、windows.h を
インクルードすれば使えます。
このマクロには、指定できるパスの最大文字数が定義されています。
たぶん Win95 以上なら 256 だと思います。

注意することは、char path[MAX_PATH + MAX_PATH]; の変数の値は
かならず 0 (正確には '\0') で初期化します。

値を 0 で初期化するには memset() を使ってもよいですが
どうせウィンドウズでしか動かないプログラムですから
ZeroMemory() を使えば、多少は楽ですかね・・・。

lpstrFileTitle には、選択されたファイルのパスを含まない
ファイル名を格納する配列のポインタ（配列の先頭アドレス）を
指定します。

lpstrFile と同じように値をセットする前に
char filename[MAX_PATH]; こんな感じで文字列を格納するための
配列を宣言して ZeroMemory( filename, sizeof( filename ) );
こんな感じで配列の値を 0 で初期化しておきます。

lpstrFilter は、開くファイルの種類を選ぶためのフィルターと
いうものを指定します。

ファイルを開くダイアログボックスの下のほうに、ファイルの種類を
選ぶコンボボックスがありますが、そこに入ってる
「すべてのファイル(*.*)」とか「ビットマップ(*.bmp)」とかの
ことです。

以下に例を書きます。

"ビットマップ(*.bmp)\0*.bmp\0すべてのファイル(*.*)\0*.*\0\0"

こんな風になります。

"表示する文字１\0対応する拡張子１\0表示する文字２\0対応する拡張子２\0・・・・\0"

コンボボックスに表示させる文字を書いて、\0 で区切って、対応する
拡張子を書いて \0 で区切るという繰り返しになっています。
最後には終わりの目印として、もうひとつ \0 をつけます。

nMaxFile には lpstrFile に格納できる文字数（バイト数）を
指定します。
lpstrFile に値をセットするときに char path[MAX_PATH + MAX_PATH]
という配列を宣言しましたが、この配列と同じサイズ
MAX_PATH + MAX_PATH を指定すればよいと思います。
間違っても MAX_PATH + MAX_PATH より大きい値は指定しないように
しましょう。

nMaxFileTitle は lpstrFileTitle に格納できる文字数（バイト数）を
指定します。
lpstrFileTitle で char filename[MAX_PATH]; と宣言した場合は
MAX_PATH を指定します。

構造体の値が設定できたら GetOpenFileName() 関数を使って
ダイアログボックスを開きます。
値が正しく設定できていればダイアログが開くはずです。


【サンプルについて】


OPENFILENAME 構造体はメンバ変数の数がやたら多い上に、普段は使用しない
ような値が多いので、自分で新しく OPENDIALOG という構造体を作って
それを利用しています。
ファイルを開くダイアログを表示する時には自作関数の ShowOpenDialog()
関数を使っています。
関数を呼び出す前に OPENDIALOG 構造体のメンバ変数に値を設定して、この
構造体のポインタを ShowOpenDialog() 関数に渡しています。

| home |