DocumentList.Filter プロパティ

.NET Framework クラス ライブラリ リファレンス

DocumentList.Filter プロパティ

ファイル フィルタ処理の指定を取得または設定します。

名前空間: Microsoft.WindowsCE.Forms
アセンブリ: Microsoft.WindowsCE.Forms (microsoft.windowsce.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Filter As
 String

Visual Basic (使用法)

Dim instance As DocumentList
Dim value As String

value = instance.Filter

instance.Filter = value

C#

public string Filter { get;
 set; }

C++

public:
property String^ Filter {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Filter ()

/** @property */
public void set_Filter (String value)

JScript

public function get Filter
 () : String

public function set Filter
 (value : String)

プロパティ値
現在指定されているファイル フィルタ処理。

例外

例外の種類	条件
ArgumentException	フィルタ処理の指定が無効です。

解説

各フィルタ処理オプションのフィルタ文字列には、フィルタの説明に続いて縦棒 (|) とフィルタ パターンが含まれます。領域が制限されているため、Pocket PC のガイドラインでは、説明を省略することをお勧めしています。説明を省略する場合は、縦棒の前にスペースが必要です。

たとえば、次のフィルタ文字列には、説明が含まれています。

"Text files (*.txt)|*.txt"

説明を省く場合、このフィルタ文字列は次のようになります。

" |*.txt"

また、フィルタ処理オプションも縦棒で区切ります。セミコロン (;) を使用することによって、フィルタ処理オプション内の複数のフィルタ パターンを表すことができます。次のフィルタ文字列では、5 つのフィルタ処理オプションを指定しています。

" |*.*| |*.pwi;*.pdt| |*.rtf| |*.txt| |*.xml"

ユーザーに最初に表示するフィルタ処理オプションを指定するには、FilterIndex プロパティを使用します。FilterIndex は、0 から始まります。フィルタ文字列を使用する場合、インデックス値は次のとおりです。

インデックス値	フィルタ パターン
0	*.*
1	*.pwi;*.pdt
2	*.rtf
3	*.txt
4	*.xml

使用例

Filter プロパティを設定するコード例を次に示します。このコード例は、DocumentList クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

.Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| |*.pxl;*.psw| |*.jpg;*.gif;*.bmp|
 |*.wav;*.wmv;*.mpg;"

C#

DocList.Filter = " |*.*| |*.txt;*.xml| |*.pwi;*.pdt| " +
   "|*.pxl;*.psw| |*.jpg;*.gif;*.bmp| |*.wav;*.wmv;*.mpg;";

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows Mobile for Pocket PC

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DocumentList クラス
DocumentList メンバ
Microsoft.WindowsCE.Forms 名前空間