ComboBox Denetim Türü iç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, ComboBox 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 arasında UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri, denetim desenleri ve UI Otomasyonu olayları için belirli yönergeler bulunur.
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, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm birleşik giriş kutusu denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, birleşik giriş kutusu 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ğaca Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| ComboBox - Düzenle (0 veya 1) - Liste (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ş kutusu, Çalıştır iletişim kutusundaki birleşik giriş kutusu gibi herhangi bir giriş alacak şekilde düzenlenebiliyorsa gereklidir.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı birleşik giriş kutusu denetimleriyle özellikle 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. |
| ControlTypeProperty | ComboBox | Bu değer tüm ui çerçeveleri için aynıdır. |
| HelpTextProperty | Notlara bakın. | Birleşik giriş kutusu denetimleri için yardım metni, kullanıcının 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." |
| IsContentElementProperty | True | Birleşik giriş kutusu denetimleri her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | Birleşik giriş kutusu denetimleri her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| IsKeyboardFocusableProperty | True | Birleşik giriş kutusu denetimleri, seçim kapsayıcısından bir dizi öğeyi kullanıma sunar. Birleşik giriş kutusu denetimi klavye odağını alabilir, ancak UI Otomasyonu istemcisi odağı birleşik giriş kutusuna ayarlarken, birleşik giriş kutusu alt ağacındaki tüm öğeler odağı alabilir. |
| LabeledByProperty | Notlara bakın. | Birleşik giriş kutusu denetimleri genellikle bu özelliğin başvurduğunu statik bir metin etiketine sahiptir. |
| LocalizedControlTypeProperty | "birleşik giriş kutusu" | ComboBox denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Birleşik giriş kutusu denetimi genellikle adını statik metin denetiminden alır. |
Gerekli UI Otomasyonu 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 | Yes | Birleşik giriş kutusu denetimi, birleşik giriş kutusu olması için her zaman açılan düğmeyi içermelidir. |
| ISelectionProvider | Yes | Birleşik giriş kutusunda geçerli seçimi görüntüler. Bu destek, birleşik giriş kutusunun altındaki liste kutusuna devredilir. |
| IValueProvider | -Sına bağ -lıdır | Birleşik giriş kutusunda rastgele metin değerleri alma özelliği varsa, Değer deseninin desteklenmesi gerekir. Bu düzen, birleşik giriş kutusunun dize içeriğini program aracılığıyla ayarlama olanağı sağlar. Değer deseni desteklenmiyorsa, kullanıcının birleşik giriş kutusunun alt ağacı içindeki liste öğelerinden seçim yapması gerektiğini gösterir. |
| IScrollProvider | Asla | Kaydırma düzeni hiçbir zaman doğrudan birleşik giriş kutusunda desteklenmez. Birleşik giriş kutusunun içindeki bir liste kutusu kaydırılabilirse desteklenir. Yalnızca liste kutusu ekranda göründüğünde desteklenebilir. |
Gerekli Olaylar
Aşağıdaki tabloda, tüm birleşik giriş kutusu 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 |
|---|---|---|
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |
| ExpandCollapseStateProperty property-changed olayı. | Zorunlu | Hiçbiri |
| ValueProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Değer desenini destekliyorsa bu olayı desteklemesi gerekir. |