Metin Denetim Türü
Bu konu, Metin denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar.
Metin denetimi, ekrandaki bir metin parçasını temsil eden temel bir 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, UI çerçevesinin/platformunun denetim türleri ve denetim desenleri için UI Otomasyonu desteğini tümleştirdiği tüm ağaç denetimleri için geçerlidir.
Bu konu aşağıdaki bölümleri içerir.
- Tipik Ağaç Yapısı
- İlgili Özellikler
- Gerekli Denetim Desenlerini
- Gerekli Olayları
- İlgili konular
Tipik Ağaç Yapısı
Aşağıdaki tabloda, metin denetimleriyle ilgili ui Otomasyonu ağacının tipik bir denetimi 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 denetimi tek başına etiket olarak veya formda statik metin olarak kullanılabilir. Aşağıdaki öğelerden birinin yapısı içinde de bulunabilir:
Metin genellikle başka bir denetimin Adı özelliği aracılığıyla görüntülendiğinden, metin denetimleri UI Otomasyonu ağacının içerik görünümünde görünmeyebilir. Örneğin, birleşik giriş kutusu denetimini etiketlemek için kullanılan metin, denetimin Adı özelliği 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. Köprü gibi eklenmiş bir nesne varsa, metin denetimlerinin içerik görünümünde alt öğeleri olabilir.
İlgili Özellikler
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. UI Automation Öğelerinden Özellikleri Alma.
| UI Otomasyonu Özelliği | Değer | Notlar |
|---|---|---|
| UIA_AutomationIdPropertyId | Notlara bakın. | Bu özelliğin değeri, UI Otomasyonu ağacının ham görünümündeki tüm eş öğeler arasında benzersiz olmalıdır. |
| UIA_BoundingRectanglePropertyId | Notlara bakın. | Denetimin tamamını içeren en dıştaki dikdörtgen. |
| UIA_ClickablePointPropertyId | 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 öğesi özel isabet testi gerçekleştiriyorsa, geçersiz kılın ve tıklanabilir bir nokta sağlayın. |
| UIA_ControlTypePropertyId | metin | |
| UIA_IsContentElementPropertyId | -Sına bağ -lıdır | Metin denetimi, başka bir denetimin Name özelliğinde sunulmayan bilgiler içeriyorsa içeriktir. |
| UIA_IsControlElementPropertyId | DOĞRU | Metin denetimi her zaman bir denetim olmalıdır. |
| UIA_IsKeyboardFocusablePropertyId | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| UIA_LabeledByPropertyId | SIFIR | Metin denetimlerinin statik metin etiketi yoktur. |
| UIA_LocalizedControlTypePropertyId | Notlara bakın. | Metin denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "text" değeridir. |
| UIA_NamePropertyId | Notlara bakın. | Metin denetiminin adı, görüntülenen metin olabilir. Ancak, denetim Metin desenini de destekliyorsa ve metin kapsamlıysa, Adı değeri olarak tam metin içeriğini kullanmayın. Bunun yerine, denetiminizin diğer özelliklerinden türetilen daha kısa bir Name değeri sağlayın. |
Gerekli 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 |
|---|---|---|
| IGridItemProvider | -Sına bağ -lıdır | Metin denetimi bir tablo denetimi içinde yer alırsa, GridItem denetim deseni desteklenmelidir. |
| ITableItemProvider | -Sına bağ -lıdır | Metin denetimi bir tablo denetimi içinde yer alırsa, tableitem denetim düzeni desteklenmelidir. |
| 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. |
| IValueProvider | Hiç | Metin denetimi hiçbir zaman Değer denetim desenini desteklemez. Metin düzenlenebilirse Düzenleme denetim türü. |
Gerekli Olaylar
Aşağıdaki tabloda, metin denetimlerinin desteklemesi gereken UI Otomasyonu olayları listelenir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.
| UI Otomasyonu Olayı | Notlar |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| özelliği değiştirilmiş olayı UIA_BoundingRectanglePropertyId. | |
| özelliği değiştirilmiş olayı UIA_IsEnabledPropertyId. | Denetim IsEnabledözelliğini destekliyorsa bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_IsOffscreenPropertyId. | Denetim IsOffscreen özelliğini destekliyorsa, bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_NamePropertyId. | |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Denetim Metin denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
İlgili konular