Aracılığıyla paylaş


ComboBox Denetim Türü

Bu konu başlığında, ComboBox denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlanır.

Birleşik giriş kutusu, birleşik giriş kutusunun liste kutusu bölümünde seçili durumdaki öğeyi görüntüleyen statik denetim veya düzenleme denetimiyle birleştirilmiş bir liste kutusudur. Denetimin liste kutusu bölümü her zaman görüntülenir veya yalnızca kullanıcı denetimin yanındaki açılan oku (bir basma düğmesidir) seçtiğinde görüntülenir. Seçim alanı bir düzenleme denetimiyse, kullanıcı listede olmayan bilgileri girebilir; aksi takdirde, kullanıcı yalnızca listedeki öğeleri seçebilir.

Aşağıdaki bölümler, ComboBox denetim türü için gerekli UI Otomasyonu ağaç yapısını, özelliklerini, denetim desenlerini ve olaylarını tanımlar. 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 birleşik giriş kutusu denetimlerine uygulanır.

Bu konu aşağıdaki bölümleri içerir.

Tipik Ağaç Yapısı

Aşağıdaki tabloda, birleşik giriş kutusu 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ü
  • ComboBox
    • Düzenle (0 veya 1)
    • Liste (0 veya 1)
    • Liste Öğesi (Listenin alt öğesi; 0-çok)
    • Düğme (1)
  • ComboBox
    • Liste Öğesi (0 -çok)

 

Birleşik giriş kutusunun denetim görünümündeki düzenleme denetimi, yalnızca birleşik giriş almak için birleşik giriş kutusu düzenlenebiliyorsa ve çalıştır iletişim kutusundaki birleşik giriş kutusunda olduğu gibi gereklidir.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle ComboBox denetim türüyle 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 ComboBox
UIA_HelpTextPropertyId Notlara bakın. Birleşik giriş kutusu denetimleri için yardım metni, kullanıcıdan neden birleşik giriş kutusundan bir seçenek belirlemesinin isteneceğini açıklamalıdır. Metin, araç ipucu aracılığıyla sunulan bilgilere benzer. Örneğin, "Monitörünüzün ekran çözünürlüğünü ayarlamak için bir öğe seçin."
UIA_IsContentElementPropertyId DOĞRU Birleşik giriş kutusu denetimleri her zaman UI Otomasyonu ağacının içerik görünümüne eklenir.
UIA_IsControlElementPropertyId DOĞRU Birleşik giriş kutusu denetimleri her zaman UI Otomasyonu ağacının denetim görünümüne eklenir.
UIA_IsKeyboardFocusablePropertyId DOĞRU Birleşik giriş kutusu denetimleri klavye odağını alabilir; ancak UI Otomasyonu istemcisi odağı birleşik giriş kutusuna ayarladığında, birleşik giriş kutusu alt ağacındaki herhangi bir öğe odağı alabilir.
UIA_LabeledByPropertyId Notlara bakın. Birleşik giriş kutusu denetimleri genellikle bu özelliğin başvurduğunu statik bir metin etiketine sahiptir.
UIA_LocalizedControlTypePropertyId Notlara bakın. ComboBox denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "birleşik giriş kutusu" değeridir.
UIA_NamePropertyId Notlara bakın. Birleşik giriş kutusu denetiminin adı genellikle statik bir metin etiketinden oluşturulur. Statik metin etiketi yoksa, Adı özelliği için bir değer atamanız gerekir. Adı özelliği hiçbir zaman birleşik giriş kutusunun geçerli içeriğini içermemeli veya birleşik giriş kutusunun içeriği değiştiğinde değişmemelidir.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, tüm birleşik giriş kutusu 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
IExpandCollapseProvider Gerekli ExpandCollapse denetim deseni desteklenmelidir çünkü birleşik giriş kutusu denetimi her zaman bir açılan düğme içermelidir.
ISelectionProvider -Sına bağ -lıdır Birleşik giriş kutusunda geçerli seçimi görüntüler. Seçimi denetim düzeni için destek, birleşik giriş kutusunun altındaki liste kutusuna devredilir, ancak her zaman uygun olmayabilir.
IValueProvider -Sına bağ -lıdır Birleşik giriş kutusu rastgele metin değerleri alabiliyorsa, Değer denetim düzeni desteklenmelidir. Bu düzen, birleşik giriş kutusunun dize içeriğinin program aracılığıyla ayarlanmasını sağlar. Değer denetimi düzeni desteklenmiyorsa, kullanıcının birleşik giriş kutusunun alt ağacı içindeki liste öğeleri arasından seçim yapması gerekir.
IScrollProvider Hiç Kaydırma denetim düzeni hiçbir zaman doğrudan birleşik giriş kutusunda desteklenmez. Birleşik giriş kutusunun içindeki bir liste kutusu kaydırılabilirse ve yalnızca liste kutusu ekranda göründüğünde desteklenir.

 

Gerekli Olaylar

Aşağıdaki tabloda, birleşik giriş kutusu 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.
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId özelliği değiştirilmiş olay.
UIA_ValueValuePropertyId özelliği değiştirilmiş olay. Denetim Değer denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış