[Tips][OpenFileDialog] ダイアログタイトルを設定する

OpenFileDialogのタイトルバーに表示されるテキストは、Titleプロパティで設定することができます。

下記はダイアログタイトルを設定する例です。

ダイアログタイトルに「画像ファイルを選択」というテキストを表示させています。

VBの例

' [ファイルの選択]ボタンクリック時の処理
Private Sub btnOpenDialog_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnOpenDialog.Click
    '★★★ダイアログタイトルの設定★★★
    OpenFileDialog1.Title = "画像ファイルを選択"

    'フィルターの設定
    OpenFileDialog1.Filter = "画像ファイル|*.bmp;*.gif;*.png"

    'ダイアログボックスの表示
    If OpenFileDialog1.ShowDialog() = Windows.Forms.DialogResult.OK Then
        '選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = OpenFileDialog1.FileName
    End If
End Sub

C#の例

// [ファイルの選択]ボタンクリック時の処理
private void btnOpenDialog_Click(object sender, EventArgs e)
{
    // ★★ダイアログタイトルの設定★★★
    openFileDialog1.Title = "画像ファイルを選択";

    // フィルターの設定
    openFileDialog1.Filter = "画像ファイル|*.bmp;*.gif;*.png";

    // ダイアログボックスの表示
    if (openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK)
    {
        // 選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = openFileDialog1.FileName;
    }
}

[Tips][OpenFileDialog] [ファイルの種類] ボックスに表示される選択肢を設定する

OpenFileDialogボックスでは、[ファイルの種類] ボックスに表示される選択肢を設定することができます。

選択肢を設定する場合はFilterプロパティに次のような書式を設定します。

“表示する文字列|フィルターする拡張子”

たとえば、Filterプロパティに “png画像|*.png” という文字列を設定すると、[ファイルの種類]ボックスは下図のようになり拡張子が*.pngのファイルのみを選択できるようになります。

また、複数の選択肢を設定することもできます。

たとえば”png画像|*.png|gif画像|*.gif”というフィルターを設定すると、png画像の選択肢とgif画像の選択肢が追加されます。

さらに、1つの選択肢で複数の拡張子をフィルターすることもできます。

この場合は、フィルターする拡張子をセミコロン(;)で区切って指定します。

たとえば”jpg画像|*.jpg;*.jpeg”と設定すると[ファイルの種類]ボックスは下図のようになり、*.jpgと*.jpegのファイルを選択できるようになります。

下記は、以上を踏まえて[ファイルの種類] ボックスに表示される選択肢を設定する例です。

画面デザインは下記のようにしました(クリックで拡大表示します)。

VBの例

'OpefFileDialogに設定するフィルター文字列格納用変数
Private strFilter As String = ""

' [追加]ボタンクリック時の処理
Private Sub btnAdd_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnAdd.Click
    'strFilterにフィルター文字列がすでにあるか?
    If strFilter.Length > 0 Then
        '文字列の末尾に"|"を追加
        strFilter &= "|"
    End If

    '「表示する文字列|フィルターする拡張子」の文字列をstrFilterに格納
    strFilter &= txtString.Text & "|" & txtFilter.Text
End Sub

' [ダイアログの表示]ボタンクリック時の処理
Private Sub btnShowDialog_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnShowDialog.Click
    '★★★OpenFileDialogのフィルターを設定★★★
    OpenFileDialog1.Filter = strFilter

    'ダイアログボックスの表示
    If OpenFileDialog1.ShowDialog() = Windows.Forms.DialogResult.OK Then
        '選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = OpenFileDialog1.FileName
    End If
End Sub

C#の例

// OpefFileDialogに設定するフィルター文字列格納用変数
private string strFilter = "";

// [追加]ボタンクリック時の処理
private void btnAdd_Click(object sender, EventArgs e)
{
    // strFilterにフィルター文字列がすでにあるか?
    if ( strFilter.Length > 0 )
    {
        //文字列の末尾に"|"を追加
        strFilter += "|";
    }

    //「表示する文字列|フィルターする拡張子」の文字列をstrFilterに格納
    strFilter += txtString.Text + "|" + txtFilter.Text;
}

// [ダイアログの表示]ボタンクリック時の処理
private void btnShowDialog_Click(object sender, EventArgs e)
{
    // ★★★OpenFileDialogのフィルターを設定★★★
    openFileDialog1.Filter = strFilter;

    // ダイアログボックスの表示
    if ( openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK )
    {
        // 選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = openFileDialog1.FileName;
    }
}

実行例は下記の通りです。




[Tips][OpenFileDialog] ダイアログに表示される起動ディレクトリを取得/設定する

OpenFileDialogが表示されたときに最初に選択されているフォルダー(起動ディレクトリ)を設定するにはInitialDirプロパティを使用します。

InitialDirプロパティには存在するパスの文字列を設定します。

下記は起動ディレクトリを設定する例です。

画面デザインは下記のようにしました。

VBの例

' [ファイルの選択]ボタンクリック時の処理
Private Sub btnOpenDialog_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnOpenDialog.Click
    If IO.Directory.Exists(txtInitialDir.Text) Then
        OpenFileDialog1.InitialDirectory = txtInitialDir.Text
    End If

    'ダイアログボックスの表示
    If OpenFileDialog1.ShowDialog() = Windows.Forms.DialogResult.OK Then
        '選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = OpenFileDialog1.FileName
    End If
End Sub

C#の例

// [ファイルの選択]ボタンクリック時の処理
private void btnOpenDialog_Click(object sender, EventArgs e)
{
    // [起動ディレクトリ]テキストボックスに入力された
    // ディレクトリが存在するか?
    if (System.IO.Directory.Exists(txtInitialDir.Text))
    {
        // ★★★起動ディレクトリを設定する★★★
        openFileDialog1.InitialDirectory = txtInitialDir.Text;
    }

    // ダイアログボックスの表示
    if (openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK)
    {
        // 選択されたファイルをテキストボックスに表示する
        txtSelectedFile.Text = openFileDialog1.FileName;
    }
}

 

実行例は下図の通りです。