Metin Denetim Türü İçin UI Otomasyon Desteği

Not

Bu belgeler, ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine System.Windows.Automation yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.

Bu konu, Metin denetim türü için UI Otomasyonu desteği hakkında bilgi sağlar. UI Otomasyonu denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidirControlTypeProperty. Koşullar, UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.

Metin denetimleri, ekrandaki bir metin parçasını temsil eden temel kullanıcı arabirimi öğesidir.

Aşağıdaki bölümlerde, Metin denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm metin denetimleri için geçerlidir.

Gerekli UI Otomasyonu Ağaç Yapısı

Aşağıdaki tabloda, metin denetimleriyle ilgili UI Otomasyonu ağacının denetim görünümü ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceği açıklanır. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyonu Ağacına Genel Bakış.

Denetim Görünümü İçerik Görünümü
Metin Metin (içerikse)

Metin denetimi tek başına etiket olarak veya formda statik metin olarak kullanılabilir. Ayrıca, aşağıdakilerin yapısında da bulunabilir:

  • Listıtem

  • Treeıtem

  • Dataıtem

Metin genellikle başka bir denetimin aracılığıyla görüntülendiğinden, metin denetimleri UI Otomasyonu ağacının NameProperty İçerik Görünümünde olmayabilir. Örneğin Birleşik Giriş Kutusu denetimini etiketlemek için kullanılan metin, denetimin NameProperty değeri aracılığıyla kullanıma sunulur. Birleşik Giriş Kutusu denetimi UI Otomasyonu Ağacı'nın içerik görünümünde olduğundan, metin denetiminin orada olması gerekmez. Metin denetimlerinin içerik görünümünde her zaman 0 alt öğe vardır

Gerekli UI Otomasyonu Özellikleri

Aşağıdaki tabloda, değeri veya tanımı özellikle metin denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.

UI Otomasyonu Özelliği Değer Notlar
AutomationIdProperty Notlara bakın. Bu özelliğin değerinin bir uygulamadaki tüm denetimlerde benzersiz olması gerekir.
BoundingRectangleProperty Notlara bakın. Denetimin tamamını içeren en dıştaki dikdörtgen.
ClickablePointProperty Notlara bakın. Sınırlayıcı bir dikdörtgen varsa desteklenir. Sınırlayıcı dikdörtgenin içindeki her nokta tıklanabilir değilse ve özel isabet testi gerçekleştiriyorsanız, geçersiz kılın ve tıklanabilir bir nokta sağlayın.
IsKeyboardFocusableProperty Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir.
NameProperty Notlara bakın. Metin çubuğu denetiminin adı her zaman görüntülediği txt'dir.
LabeledByProperty Null Metin denetimlerinin statik metin etiketi yoktur.
ControlTypeProperty Metin Bu değer tüm ui çerçeveleri için aynıdır.
LocalizedControlTypeProperty "metin" Metin denetim türüne karşılık gelen yerelleştirilmiş dize.
IsContentElementProperty -Sına bağ -lıdır Metin denetimi, başka bir denetimin NameProperty dosyasında sunulmayan bilgiler içeriyorsa içerik olur.
IsControlElementProperty True Metin denetimi her zaman bir denetim olmalıdır.

Gerekli UI Otomasyonu Denetim Desenleri

Aşağıdaki tabloda, metin denetimleri tarafından desteklenmesi için gereken UI Otomasyonu denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.

Denetim Deseni Destek Notlar
IValueProvider Asla Metin hiçbir zaman ValuePattern'ı desteklemez. Metin düzenlenebilirse, düzenleme denetim türü budur.
ITextProvider -Sına bağ -lıdır Metin, daha iyi erişilebilirlik için Metin denetim desenini desteklemelidir; ancak gerekli değildir. Metin denetim düzeni, zengin stil ve özniteliklere (örneğin, renk, kalın ve italik) sahip olduğunda kullanışlıdır. Çerçeveye bağlıdır.
ITableItemProvider -Sına bağ -lıdır Metin öğesi tablo denetiminde yer alırsa, bu desteklenmelidir.
IRangeValueProvider -Sına bağ -lıdır Metin öğesi bir tablo denetimi içinde yer alırsa, bu desteklenmelidir.

Gerekli UI Otomasyonu Olayları

Aşağıdaki tabloda, tüm metin denetimleri tarafından desteklenmesi için gereken UI Otomasyonu olayları listelenmektedir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylara Genel Bakış.

UI Otomasyonu Olayı Destek Notlar
TextSelectionChangedEvent Zorunlu Hiçbiri
TextChangedEvent Zorunlu Hiçbiri
BoundingRectangleProperty property-changed olayı. Zorunlu Hiçbiri
IsOffscreenProperty property-changed olayı. Zorunlu Hiçbiri
IsEnabledProperty property-changed olayı. Zorunlu Hiçbiri
NameProperty property-changed olayı. Zorunlu Hiçbiri
ValueProperty property-changed olayı. Asla Hiçbiri
AutomationFocusChangedEvent Zorunlu Hiçbiri
StructureChangedEvent Zorunlu Hiçbiri

Ayrıca bkz.