2024/06/03 電子書籍「電子書籍出版・技術文書作成を劇的に加速！秀丸エディタ + Markdown + Pandocの驚異」を出版

TFileOpenDialogの使い方

C++Builder
2024.06.10

C++Builderで、ファイルを開くダイアログボックスを表示するにはTOpenDialogクラスTFileOpenDialogクラスを使用します。

この記事では、TFileOpenDialogの基本的な使い方を説明します。

Vista および、より新しい Windows オペレーティング システム スタイルの、ファイルを開くためのダイアログのクラスです。

TFileOpenDialog

TFileOpenDialogの使い方を説明します。

Vcl.Dialogs.TFileOpenDialog - RAD Studio API Documentation
docwiki.embarcadero.com

サンプルコード1

TFileOpenDialogのサンプルコードです。

	FileOpenDialog1->Title			="画像ファイルをを選択してください";
	FileOpenDialog1->FileNameLabel	= "画像のファイル名:";	// ファイル名編集ボックスの隣にあるラベルのテキスト。
	FileOpenDialog1->OkButtonLabel	= "画像を開く"; 		// 開く または 保存 ボタンのテキスト。
	FileOpenDialog1->Options << fdoAllowMultiSelect;

	FileOpenDialog1->DefaultFolder	= "D:\\画像\\";

	// ----------------
	TFileTypeItem *FileType;
	FileOpenDialog1->FileTypes->Clear();
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "画像ファイル";
	FileType->FileMask		= "*.bmp;*.dib;*.jp*;*.gif;*.png;*.webp;*.ICO;*.TIF*;*.heic";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "JPEG";
	FileType->FileMask		= "*.jp*";

	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "PNG";
	FileType->FileMask		= "*.png*";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "webp";
	FileType->FileMask		= "*.webp";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "BMP";
	FileType->FileMask		= "*.bmp;*.dib";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "GIF";
	FileType->FileMask		= "*.gif";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "TIFF";
	FileType->FileMask		= "*.tif*";

	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "ICON";
	FileType->FileMask		= "*.ico*";

	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "heic";
	FileType->FileMask		= "*.heic*";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "全";
	FileType->FileMask		= "*.*";
	
	if (FileOpenDialog1->Execute())
	{
		if(FileOpenDialog1->Files->Count > 0)
		{
			Memo1->Lines->Assign(FileOpenDialog1->Files);
		}
	}

実行結果です。

サンプルコード2

TFileOpenDialogを使用して、フォルダを選択するサンプルコードです。

Optionsに、fdoPickFolders を設定するとファイルではなくフォルダを選択する事ができます。

	FileOpenDialog1->Title			="フォルダを選択してください";
	FileOpenDialog1->FileNameLabel	= "フォルダ名:";	// ファイル名編集ボックスの隣にあるラベルのテキスト。
	FileOpenDialog1->OkButtonLabel	= "フォルダの選択"; 		// 開く または 保存 ボタンのテキスト。
	FileOpenDialog1->Options << fdoPickFolders << fdoAllowMultiSelect;

	FileOpenDialog1->DefaultFolder	= "D:\\画像\\";
	
	if (FileOpenDialog1->Execute())
	{
		if(FileOpenDialog1->Files->Count > 0)
		{
			Memo1->Lines->Assign(FileOpenDialog1->Files);
		}
	}

実行結果です。

主なプロパティ

主なプロパティの一覧です。

主なプロパティ種別説明
FileNamepublished選択されたファイル名。
FileNameLabelpublishedファイル名編集ボックスの隣にあるラベルのテキスト。
Filespublic選択されたファイル名のリスト。
FileTypeIndexpublishedダイアログを開いたときに、デフォルトで選択されているフィルタを指定します。
FileTypespublishedファイル タイプのリストです。
Namepublishedコードで参照されている、コンポーネントの名前を示します。
OkButtonLabelpublished開く または 保存 ボタンのテキストです。
Optionspublishedダイアログの制御するオプションのリストです。
TagpublishedNativeInt 整数値をコンポーネントの一部として保持します。
Titlepublishedダイアログのタイトルです。
主なプロパティ

FileTypes

FileTypes は TFileTypeItems のインスタンスで、ファイル タイプのリストを保有しており、それぞれが TFileTypeItem のインスタンスです。
ファイル タイプをダイアログに追加するには、TFileTypeItems インスタンスを FileTypes から取得し、次のサンプルにあるように、TFileTypeItems.Add メソッドを使用します。

FileTypes->Add()でTFileTypeItemを新規に作成し、DisplayNameと、FileMaskを設定します。

	TFileTypeItem *FileType;
	FileOpenDialog1->FileTypes->Clear();
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "画像ファイル";
	FileType->FileMask		= "*.bmp;*.dib;*.jp*;*.gif;*.png;*.webp;*.ICO;*.TIF*;*.heic";
	// ----------------
	FileType				= FileOpenDialog1->FileTypes->Add();
	FileType->DisplayName	= "JPEG";
	FileType->FileMask		= "*.jp*";

OkButtonLabel

OkButtonLabelを使用すると、開く または 保存 ボタンのテキストを設定できます。

FileOpenDialog1->OkButtonLabel	= "画像を開く"; 		// 開く または 保存 ボタンのテキスト。

Options

ダイアログの制御するオプションのリストです。

次の表に，指定できる値を示します。

値意味
fdoOverWritePromptファイルを保存するときに，同じ名前の既存ファイルを上書きする前にプロンプトを表示します。 これは保存ダイアログのデフォルトです。
fdoStrictFileTypes保存するファイルのファイル拡張子が選択したファイルの種類と一致している必要があります。
fdoNoChangeDir未使用。
fdoPickFoldersファイルではなくフォルダを選択します。
fdoForceFileSystemファイルシステム項目を返す必要があります。
fdoAllNonStorageItemsシェル名前空間内の任意の項目を選択できます。 このフラグを fdoForceFileSystem と組み合わせることはできません。
fdoNoValidate選択したファイルをアプリケーションが開くことを禁止する状況（共有違反，アクセス拒否エラーなど）がないかどうかをチェックしません。
fdoAllowMultiSelect開くダイアログで複数の項目を選択できます。
fdoPathMustExist既存のフォルダ内の項目を返す必要があります。 これはデフォルトです。
fdoFileMustExist存在する項目を返す必要があります。 これは，開くダイアログのデフォルト値です。
fdoCreatePrompt保存ダイアログで返す項目が存在しない場合に作成を確認するメッセージを表示します。 項目の作成は行いません。
fdoShareAwareファイルを開く際に共有違反があった場合は，アプリケーションをコールバックして通知します。 このフラグは fdoNoValidate によって無効になります。
fdoNoReadOnlyReturn読み取り専用項目を返しません。
fdoNoTestFileCreate保存ダイアログから返される項目の作成をテストしません。 これを設定しない場合は，呼び出し側のアプリケーションが作成テストで検出されたエラーを処理する必要があります。
fdoHideMRUPlaces最近開いたまたは保存した項目の場所を非表示にします。
fdoHidePinnedPlacesユーザーが選択できるピン設定された場所を非表示にします。
fdoNoDereferenceLinksショートカットをショートカットのターゲット項目として処理しません。つまり，アプリケーションは .lnk ファイルを開くことができます。
fdoDontAddToRecent開くまたは保存する項目を最近の場所のリストに追加しません。
fdoForceShowHidden非表示の項目を表示します。
fdoDefaultNoMiniMode保存ダイアログボックスを拡張モードで開きます。拡張モードでは，ユーザーがフォルダを参照できます。 保存ダイアログボックスの左下隅にあるボタンをクリックすると，拡張モードを設定したり解除することができます。
fdoForcePreviewPaneOnプレビューペインを表示します。

スポンサーリンク
タイトルとURLをコピーしました