TextSearch 类

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

使用户能够通过键入字符串的前缀来快速访问组中的项。

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 每个项的属性，第二个示例设置 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>

注解

此类用于将字符串分配给控件集合中的项。 将字符串分配给集合中的每个项可实现两个目标。 它指定要在选定项目时显示的文本，并允许用户通过键入分配的字符串来选择项目。

例如，假设包含 ComboBox 对象的集合 Image ，其中一个对象是狗的图像。 如果将字符串“Dog”分配给该项目，则用户可以通过在组合框的文本框中键入单词来选择该狗。 一旦用户键入足够的单词来区分所选内容中的其他项目，就会选择狗的图像。 如果 IsEditable 设置为 true On， ComboBox“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