TSaveDialogの使い方

C++Builderでファイルの保存を行うコンポーネントには、TSaveDialogとTFileSaveDialogコンポーネントがあります。この記事では、TSaveDialogに使い方について説明します。

TSaveDialogは、古いバージョンのWindowsとも互換性があります。

TSaveDialogの使い方

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

Vcl.Dialogs.TSaveDialog - RAD Studio API Documentation

docwiki.embarcadero.com

サンプルコード

void __fastcall TSDIAppForm::FileSave1Execute(TObject *Sender)
{    
	String fname	= "D:\\画像\\201411\\small\\2014-11-15 12.55.55.jpg";

	SaveDialog->Filter = "JPEG|*.jpg|PNG|*.png|webp|*.webp|BMP|*.bmp|GIF|*.gif|TIFF|*.TIF|icon|*.ico";
	SaveDialog->FileName = TPath::GetFileName(fname);
	SaveDialog->InitialDir = TPath::GetDirectoryName(fname);

	if (SaveDialog->Execute())
	{
		// Memo1->Lines->Add(SaveDialog->FileName);
		// Memo1->Lines->Add(IntToStr(SaveDialog->FilterIndex));
	}
}

実行結果です。

主なプロパティ

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

Filter

ダイアログボックスで使用できるファイルマスク（フィルタ）を指定します。

ファイル選択用のダイアログボックスには，編集ボックスにファイルの種類を表示するドロップダウンリストがあります。ユーザーがリストからファイルの種類を選択すると，選択した種類のファイルだけがダイアログボックスに表示されます。

設計時にファイルマスクを作成するには，オブジェクトインスペクタで Filter プロパティの右側にある省略記号（…）をクリックします。これで Filter エディタが開きます。Filter エディタの左列の Filter 名の下に，実行時に使用できる各ファイルの種類の簡単な説明を入力します。右の列の Filter の下には，各説明に対応するファイルマスクを入力します。たとえば，マスク「*.txt」の左には「テキストファイル」という説明が表示され，「*.pas」の左には「Pascal のソースファイル」という説明が表示されます。実行時にはドロップダウンリストに説明が表示されるので，フィルタマスクを明示的に示す方が使用しやすくなります（たとえば「テキストファイル（*.txt）」など）。

プログラムコードでファイルマスクを作成するには，縦棒（パイプ）で区切られた説明とマスクで構成される Filter プロパティに値を代入します。縦棒の両側にはスペースを入れないでください。次に例を示します。

複数のフィルタは縦棒で区切らなければなりません。次に例を示します。

OpenDialog1->Filter = "Text files (*.txt)|*.TXT|Pascal files (*.pas)|*.PAS";

1 つのフィルタに複数のマスクを含めるには，マスクをセミコロンで区切ります。これはオブジェクトインスペクタとプログラムコードの両方で機能します。次に例を示します。

OpenDialog1->Filter = "Pascal files|*.PAS;*.DPK;*.DPR";

Filterプロパティに値が代入されていない場合，ダイアログボックスはすべてのファイルの種類を表示します。

DefaultExt

デフォルトのファイル拡張子を指定します。

DefaultExtは，選択されたファイル名に登録されている拡張子が含まれていない場合に，選択されたファイル名に自動的に付けられるファイル拡張子を指定します。ユーザーが登録されていない拡張子を持つファイル名を選択した場合，DefaultExtプロパティが示すデフォルトの拡張子がその登録されていない拡張子に追加されます。

3 文字を超える拡張子はサポートされていません。ファイル名と拡張子を分けるピリオド（.）は入力しないでください。

InitialDir

ダイアログボックスが開いたときのカレントディレクトリを指定します。

InitialDir プロパティは，ファイル選択用のダイアログボックスが開いたときに表示されるデフォルトのディレクトリを指定します。たとえば，WINDOWS\SYSTEM ディレクトリをデフォルトにする場合は，InitialDir プロパティの値を C:\WINDOWS\SYSTEM に設定します。

InitialDir プロパティに値が代入されていない場合，または指定したディレクトリが存在しない場合，初期ディレクトリはグローバルの ForceCurrentDirectory 変数で制御されます。ForceCurrentDirectory が true の場合，ダイアログに現在の作業ディレクトリが表示されます。それ以外の場合は，Windows のバージョンに応じて，現在の作業ディレクトリ（NT）または My Documents ディレクトリのどちらかが表示されます。

Options

TOpenOption および TOpenOptions により、ファイル選択ダイアログの動作が決まります。

TOpenOption の値により、ファイル選択ダイアログの外見と動作が決まります。TOpenOptions は TOpenOption の値の集合です。

取り得る値の一覧を次の表に示します。

• Vcl.Dialogs.TOpenOptions