TextSearch クラス

リファレンス

定義

名前空間:: System.Windows.Controls

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザーが文字列のプレフィックスを入力して、セット内の項目にすばやくアクセスできるようにします。

public ref class TextSearch sealed : System::Windows::DependencyObject

public sealed class TextSearch : System.Windows.DependencyObject

type TextSearch = class
    inherit DependencyObject

Public NotInheritable Class TextSearch
Inherits DependencyObject

継承: Object

DispatcherObject

DependencyObject
TextSearch

例

次の例では、テキストではなく項目として画像を含むコントロールを作成 ComboBox します。機能的には、例は同じです。最初の例では、プロパティを設定し TextPath 、 ComboBox 2 番目の例では、コレクション内の Text 各項目にプロパティを設定します。

<ComboBox IsEditable="true" TextSearch.TextPath="Name">
  <Image Name="Cat" Source="data\cat.png"/>
  <Image Name="Dog" Source="data\dog.png"/>
  <Image Name="Fish" Source="data\fish.png"/>
</ComboBox>

<ComboBox IsEditable="true">
  <Image TextSearch.Text="Cat" Source="data\cat.png"/>
  <Image TextSearch.Text="Dog" Source="data\dog.png"/>
  <Image TextSearch.Text="Fish" Source="data\fish.png"/>
</ComboBox>

注釈

このクラスは、コントロールのコレクション内の項目に文字列を割り当てるために使用されます。コレクション内の各項目に文字列を割り当てると、2 つの目的が達成されます。項目が選択されたときに表示するテキストを指定し、割り当てられた文字列を入力して項目を選択できるようにします。

たとえば、あるオブジェクトのImageコレクションがComboBox含まれているとします。そのうちの 1 つは犬の画像です。文字列 "Dog" をその項目に割り当てると、ユーザーはコンボボックスのテキストボックスに単語を入力して犬を選択できます。ユーザーが選択内の他の項目と区別するのに十分な数の単語を入力するとすぐに、犬の画像が選択されます。オンにtrueComboBox設定されている場合IsEditableは、テキストボックスに "Dog" が表示されます。

コントロールのプロパティを使用するか、コントロールのコレクション内の各項目にプロパティを TextSearch.TextPath 設定することで、項目を Text 識別するテキストを指定できます。これらのプロパティのいずれかを設定すると、予期しないテキストが表示されません。コントロールのコレクション項目に Text プロパティを設定した場合、 TextPath プロパティは無視されます。プロパティを実際の TextPath プロパティの名前ではない値に設定した場合、 TextPath 無視されます。

XAML テキストの使用法

XAML でこのマネージドクラスを宣言することはできませんが、その静的プロパティを使用して XAML の値を割り当てることができます。

フィールド

TextPathProperty	TextPath 添付プロパティを識別します。
TextProperty	Text 添付プロパティを識別します。

プロパティ

DependencyObjectType	このインスタンスの DependencyObjectType CLR 型をラップする値を取得します。 (継承元 DependencyObject)
Dispatcher	この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject)
IsSealed	このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。 (継承元 DependencyObject)

添付プロパティ

Text	コントロールのコレクション内の項目を識別する文字列を取得または設定します。
TextPath	コントロールのコレクション内の各項目を識別する項目のプロパティの名前を取得または設定します。

メソッド

CheckAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 (継承元 DispatcherObject)
ClearValue(DependencyProperty)	プロパティのローカル値をクリアします。クリアするプロパティは DependencyProperty 識別子で指定されます。 (継承元 DependencyObject)
ClearValue(DependencyPropertyKey)	読み取り専用プロパティのローカル値を消去します。消去するプロパティは、DependencyPropertyKey で指定します。 (継承元 DependencyObject)
CoerceValue(DependencyProperty)	指定した依存関係プロパティの値を強制します。これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティメタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (継承元 DependencyObject)
Equals(Object)	指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (継承元 DependencyObject)
GetHashCode()	この DependencyObject のハッシュコードを取得します。 (継承元 DependencyObject)
GetLocalValueEnumerator()	どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (継承元 DependencyObject)
GetText(DependencyObject)	指定した項目を識別する文字列を返します。
GetTextPath(DependencyObject)	指定した要素のコレクション内の項目を識別するプロパティの名前を返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValue(DependencyProperty)	DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。 (継承元 DependencyObject)
InvalidateProperty(DependencyProperty)	指定した依存関係プロパティの有効値を再評価します。 (継承元 DependencyObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	この DependencyObject の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。変更された特定の依存関係プロパティは、イベントデータで報告されます。 (継承元 DependencyObject)
ReadLocalValue(DependencyProperty)	ローカルの依存関係プロパティの値を返します (存在する場合)。 (継承元 DependencyObject)
SetCurrentValue(DependencyProperty, Object)	依存関係プロパティ値のソースを変更せずにその値を設定します。 (継承元 DependencyObject)
SetText(DependencyObject, String)	Text 添付プロパティの値を指定された要素に書き込みます。
SetTextPath(DependencyObject, String)	TextPath 添付プロパティを指定した要素に書き込みます。
SetValue(DependencyProperty, Object)	依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)	依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (継承元 DispatcherObject)

適用対象

こちらもご覧ください

ComboBox