「Avalonia UI - ダイアログ」の版間の差分

61行目: 61行目:
<br>
<br>


==== Filterプロパティ(ファイルの種類)の設定 ====
==== Filtersプロパティ (ファイルの種類) の設定 ====
ダイアログで開くことができるファイルの種類は、<code>Filter</code>プロパティにフィルタ文字列を設定する。<br>
ダイアログで開くことができるファイルの種類は、<code>Filters</code>プロパティにフィルタ文字列を設定する。<br>
フィルタ文字列は、ファイルの説明とファイルの拡張子を<code>|</code>(バーティカルバー)で区切って表現する。<br>
<br>
<br>
<center>
フィルタ文字列の設定を以下に示す。<br>
表. フィルタ文字列の設定例<br>
* FileDialogFilterクラスの使用
{| class="wikitable" style="background-color:#fefefe;"
*: 各フィルタはFileDialogFilterオブジェクトとして定義される。
|-
* Nameプロパティ
! style="background-color:#00ffff;" | フィルタ
*: ユーザに表示されるフィルタの名前。
! style="background-color:#00ffff;" | フィルタ文字列
* Extensionsプロパティ
|-
*: 拡張子のリストであり、ワイルドカード (*) を含めずに指定する。
| すべてのファイル || "すべてのファイル (*.*)|*.*"
* 複数の拡張子
|-
*: 1つのフィルタに複数の拡張子を含めることができる。
| テキストファイル || "テキストファイル (*.txt)|*.txt"
* 全てのファイル
|-
*: 全てのファイルを表す場合は、拡張子として <code>"*"</code> を使用する。
| テキストファイルとすべてのファイル || "テキストファイル (*.txt)|*.txt|すべてのファイル (*.*)|*.*"
* フィルタの順序
|-
*: リストに追加した順序でユーザに表示される。
| XMLファイル || "XML ファイル (*.xml)|*.xml"
|-
| HTMLファイル || "HTML ファイル (*.html, *.htm)|*.html;*.htm"
|-
| XMLファイルとHTMLファイルとすべてのファイル || "XML ファイル (*.xml)|*.xml|HTML ファイル (*.html, *.htm)|*.html;*.htm|すべてのファイル (*.*)|*.*"
|-
| イメージファイル || "イメージファイル (*.png, *.jpg, *.gif, *bmp)|*.png;*.jpg;*.gif;*bmp"
|}
</center>
<br>
<br>
ファイルの種類を複数設定する時、起動時に選択するファイルの種類を指定する場合は、<br>
WinFormsとの主な違いを、以下に示す。<br>
<code>FilterIndex</code>プロパティにインデックス値を指定する。(既定値 : 1)<br>
* Avalonia UIでは、拡張子にワイルドカード (*) を含めずに、単に拡張子名のみを指定する。
* 複数の拡張子やファイルタイプを1つのフィルタにまとめる場合、<code>Extensions</code>リストに全ての拡張子を追加する。
* フィルタ間の区切り (<code>|</code>) は使用せず、代わりに別の<code>FileDialogFilter</code>オブジェクトを作成する。
<br>
<br>
プルダウンの先頭の項目において、2番目の項目は2を指定する。(<u>プルダウンのインデックスは、1から始まるので注意</u>)<br>
<syntaxhighlight lang="c#">
ユーザが選択したファイルの種類を保持しておき、次回に選択するファイルの種類を設定する時に便利なプロパティである。<br>
using Avalonia.Controls;
using System.Collections.Generic;
public class FileDialogExample
{
    public void ShowFileDialog()
    {
      var dialog = new OpenFileDialog();
      dialog.Filters = new List<FileDialogFilter>
      {
          new FileDialogFilter { Name = "すべてのファイル", Extensions = new List<string> { "*" } },
          new FileDialogFilter { Name = "テキストファイル", Extensions = new List<string> { "txt" } },
          new FileDialogFilter { Name = "テキストファイルとすべてのファイル", Extensions = new List<string> { "txt", "*" } },
          new FileDialogFilter { Name = "XMLファイル", Extensions = new List<string> { "xml" } },
          new FileDialogFilter { Name = "HTMLファイル", Extensions = new List<string> { "html", "htm" } },
          new FileDialogFilter { Name = "XMLファイルとHTMLファイルとすべてのファイル", Extensions = new List<string> { "xml", "html", "htm", "*" } },
          new FileDialogFilter { Name = "イメージファイル", Extensions = new List<string> { "png", "jpg", "gif", "bmp" } }
      };
      // ファイル選択ダイアログを表示
      var result = await dialog.ShowAsync(this);
      if (result != null)
      {
          foreach (var path in result)
          {
            System.Console.WriteLine($"Selected file: {path}");
          }
      }
    }
}
</syntaxhighlight>
<br>
<br>
==== 使用例 ====
==== 使用例 ====
ダイアログを表示する場合は、OpenFileDialogクラスのShowAsyncメソッドを実行する。<br>
ダイアログを表示する場合は、OpenFileDialogクラスのShowAsyncメソッドを実行する。<br>