Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Uyarı
Bu belgeler, System.Windows.Automation ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine 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'nda denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidir ControlTypeProperty . 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 Otomasyon 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ğini açıklar. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyon 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:
ListeÖgesi
TreeItem
DataItem
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, Kombo Kutusu denetimini etiketlemek için kullanılan metin, denetimin NameProperty değeri aracılığıyla sunulur. Birleşik Kutu denetimi Kullanıcı Arayüzü Otomasyon Ağacı'nın içerik görünümünde olduğundan, metin denetiminin orada olması gerekli değildir. Metin denetimlerinin, içerik görünümünde her zaman 0 çocuk öğesi bulunur.
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 UI Otomasyonu Özellikleri.
| 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 | Duruma bağlı. | Metin denetimi, başka bir denetimin NameProperty dosyasında sunulmayan bilgiler içeriyorsa içerik olur. |
| IsControlElementProperty | Doğru | Metin denetimi her zaman bir denetim olmalıdır. |
Gerekli Kullanıcı Arayüzü Otomasyonu Kontrol 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 | Hiç | Metin hiçbir zaman ValuePattern'ı desteklemez. Metin düzenlenebilirse, düzenleme denetim türü budur. |
| ITextProvider | Duruma bağlı. | 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 | Duruma bağlı. | Metin öğesi tablo denetiminde yer alırsa, bu desteklenmelidir. |
| IRangeValueProvider | Duruma bağlı. | 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 Olaylarına Genel Bakış.
| UI Otomasyonu Olayı | Destek | Notlar |
|---|---|---|
| TextSelectionChangedEvent | Gerekli | Hiç kimse |
| TextChangedEvent | Gerekli | Hiç kimse |
| BoundingRectangleProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsOffscreenProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsEnabledProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| NameProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| ValueProperty özellik değişikliği olayı. | Hiç | Hiç kimse |
| AutomationFocusChangedEvent | Gerekli | Hiç kimse |
| StructureChangedEvent | Gerekli | Hiç kimse |