TextSearch Sınıf

Tanım

Bir kullanıcının, dizelerin öneklerini yazarak bir küme içindeki öğelere hızlıca erişmesini sağlar.Enables a user to quickly access items in a set by typing prefixes of strings.

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
Devralma

Örnekler

Aşağıdaki örneklerde, ComboBox metin yerine resimleri öğe olarak içeren denetimler oluşturulur.The following examples create ComboBox controls that contain images as items instead of text. İşlevsellik, örnekleri aynı.Functionally, the examples are the same. İlk örnek TextPath , üzerinde özelliğini ayarlar ComboBox ve ikinci örnekte, Text koleksiyonundaki her öğe için özelliğini ayarlar.The first example sets the TextPath property on the ComboBox and the second example sets the Text property on each item in the collection.

<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>

Açıklamalar

Bu sınıf, bir denetimin koleksiyonundaki öğelere bir dize atamak için kullanılır.This class is used to assign a string to items in a control's collection. Koleksiyondaki her öğeye bir dize atamak iki amaç gerçekleştirir.Assigning a string to each item in the collection accomplishes two objectives. Öğe seçildiğinde görüntülenecek metni belirtir ve kullanıcının atanan dizeyi yazarak bir öğe seçmesini sağlar.It specifies the text to display when the item is selected, and it enables the user to select an item by typing the assigned string.

Örneğin, bir bir ComboBox köğin görüntüsü olan bir nesne koleksiyonu içerdiğini varsayalım Image .For example, assume that a ComboBox contains a collection of Image objects, one of which is an image of a dog. "Köpek" dizesini bu öğeye atarsanız, Kullanıcı Birleşik giriş kutusunun metin kutusuna sözcüğü yazarak köpek yapabilir.If you assign the string, "Dog" to that item, the user can select the dog by typing the word in the combo box's text box. Kullanıcı, seçimdeki diğer öğelerden ayırt etmek için sözcüğün yeterince birini yazdığında, kökün görüntüsü seçilir.As soon as the user types enough of the word to distinguish it from other items in the selection, the image of the dog will be selected. IsEditable, Üzerinde olarak ayarlandıysa true ComboBox , metin kutusunda "köpek" görünür.If IsEditable is set to true on the ComboBox, "Dog" will appear in the text box.

TextSearch.TextPathBir denetimin özelliğini kullanarak veya Text denetimin koleksiyonundaki her bir öğe üzerinde özelliğini ayarlayarak bir öğeyi tanımlayan metni belirtebilirsiniz.You can specify the text that identifies an item by using the TextSearch.TextPath property on a control or by setting the Text property on each item in the control's collection. Bu özelliklerden birini ayarlamak, beklenmeyen metinlerin görüntülenmesini sağlar.Setting one of these properties ensures that unexpected text is not displayed. TextÖzelliği bir denetimin koleksiyon öğesinde ayarlarsanız, TextPath özelliği yok sayılır.If you set the Text property on a control's collection item, the TextPath property will be ignored. TextPathÖzelliğini gerçek bir özelliğin adı olmayan bir değere ayarlarsanız, TextPath yok sayılır.If you set the TextPath property to a value that is not the name of an actual property, TextPath is ignored.

XAML Metni KullanımıXAML Text Usage

İçinde bu yönetilen sınıfı bildiremezsiniz XAMLXAML , ancak içinde değer atamak için statik özelliklerini kullanabilirsiniz XAMLXAML .You cannot declare this managed class in XAMLXAML, but you can use its static properties to assign values in XAMLXAML.

Alanlar

TextPathProperty

TextPathİliştirilmiş özelliği tanımlar.Identifies the TextPath attached property.

TextProperty

Textİliştirilmiş özelliği tanımlar.Identifies the Text attached property.

Özellikler

DependencyObjectType

DependencyObjectTypeBu örneğin türünü sarmalayan öğesini alır CLRCLR .Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Devralındığı yer: DependencyObject)
Dispatcher

Dispatcher DispatcherObject İle ilişkili olduğunu alır.Gets the Dispatcher this DispatcherObject is associated with.

(Devralındığı yer: DispatcherObject)
IsSealed

Bu örneğin şu anda kapalı olup olmadığını gösteren bir değer alır (salt okunurdur).Gets a value that indicates whether this instance is currently sealed (read-only).

(Devralındığı yer: DependencyObject)

İliştirilmiş Özellikler

Text

Bir denetimin koleksiyonundaki bir öğeyi tanımlayan dizeyi alır veya ayarlar.Gets or sets the string that identifies an item in a control's collection.

TextPath

Bir denetimin koleksiyonundaki her bir öğeyi tanımlayan Öğeler ' özelliğinin adını alır veya ayarlar.Gets or sets the name of the items' property that identifies each item in a control's collection.

Yöntemler

CheckAccess()

Çağıran iş parçacığının bu öğesine erişip erişemeyeceğini belirler DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)

Bir özelliğin yerel değerini temizler.Clears the local value of a property. Temizlenme özelliği bir tanımlayıcı tarafından belirtilir DependencyProperty .The property to be cleared is specified by a DependencyProperty identifier.

(Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)

Salt okunurdur özelliğinin yerel değerini temizler.Clears the local value of a read-only property. Temizlenme özelliği bir tarafından belirtilir DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Devralındığı yer: DependencyObject)
CoerceValue(DependencyProperty)

Belirtilen bağımlılık özelliğinin değerini zorlar.Coerces the value of the specified dependency property. Bu, CoerceValueCallback çağırma üzerinde olduğu gibi bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir işlevi çağırarak gerçekleştirilir DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Devralındığı yer: DependencyObject)
Equals(Object)

Belirtilen değerin geçerli olup olmadığını belirler DependencyObject DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Devralındığı yer: DependencyObject)
GetHashCode()

Bunun için bir karma kodu alır DependencyObject .Gets a hash code for this DependencyObject.

(Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()

Hangi bağımlılık özelliklerinin bunun üzerinde yerel olarak değer ayarlamış olduğunu belirlemek için özel bir Numaralandırıcı oluşturur DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Devralındığı yer: DependencyObject)
GetText(DependencyObject)

Belirtilen öğeyi tanımlayan dizeyi döndürür.Returns the string to that identifies the specified item.

GetTextPath(DependencyObject)

Belirtilen öğenin koleksiyonundaki bir öğeyi tanımlayan özelliğin adını döndürür.Returns the name of the property that identifies an item in the specified element's collection.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
GetValue(DependencyProperty)

Bir bağımlılık özelliğinin bu örneğine ait geçerli etkin değeri döndürür DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)

Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir.Re-evaluates the effective value for the specified dependency property.

(Devralındığı yer: DependencyObject)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Bunun üzerinde herhangi bir bağımlılık özelliğinin etkin değeri DependencyObject güncelleştirildiğinde çağrılır.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Değiştirilen belirli bağımlılık özelliği olay verilerinde raporlanır.The specific dependency property that changed is reported in the event data.

(Devralındığı yer: DependencyObject)
ReadLocalValue(DependencyProperty)

Varsa, bağımlılık özelliğinin yerel değerini döndürür.Returns the local value of a dependency property, if it exists.

(Devralındığı yer: DependencyObject)
SetCurrentValue(DependencyProperty, Object)

Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar.Sets the value of a dependency property without changing its value source.

(Devralındığı yer: DependencyObject)
SetText(DependencyObject, String)

TextEkli özellik değerini belirtilen öğeye yazar.Writes the Text attached property value to the specified element.

SetTextPath(DependencyObject, String)

TextPathİliştirilmiş özelliği belirtilen öğeye yazar.Writes the TextPath attached property to the specified element.

SetValue(DependencyProperty, Object)

Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir Dependency özelliğinin yerel değerini ayarlar.Sets the local value of a dependency property, specified by its dependency property identifier.

(Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)

Bir salt okuma bağımlılığı özelliğinin yerel değerini, DependencyPropertyKey bağımlılık özelliğinin tanımlayıcısıyla belirtilen şekilde ayarlar.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Serileştirme işlemlerinin, belirtilen bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini belirten bir değer döndürür.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Devralındığı yer: DependencyObject)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
VerifyAccess()

Çağıran iş parçacığının buna erişimi olmasını zorlar DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Devralındığı yer: DispatcherObject)

Şunlara uygulanır

Ayrıca bkz.