CheckBox 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, CheckBox denetim türü için Microsoft 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.
Onay kutusu, kullanıcıların bu durumda geçiş yapmak için etkileşim kurabileceği bir durumu belirtmek için kullanılan bir nesnedir. Onay kutuları kullanıcıya ikili (Evet/Hayır), (Açık/Kapalı) veya üçüncül (Açık, Kapalı, Belirsiz) seçeneği sunar.
Aşağıdaki bölümlerde CheckBox 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 onay kutusu denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, onay 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ğacına Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| CheckBox | CheckBox |
Not
Onay kutuları hiçbir zaman denetim veya içerik görünümünde alt öğelere sahip olmaz. Denetimin alt öğeler içermesi gerekiyorsa, bu başka bir denetim türünün kullanılması gerektiğini gösterir.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı onay 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 | CheckBox | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | True | Bu özelliğin değeri her zaman True olmalıdır. Bu, onay kutusu denetiminin her zaman UI Otomasyonu ağacının içerik görünümüne dahil edilmesi gerektiği anlamına gelir. |
| IsControlElementProperty | True | Bu özelliğin değeri her zaman True olmalıdır. Bu, onay kutusu denetiminin her zaman UI Otomasyonu ağacının denetim görünümüne eklenmesi gerektiği anlamına gelir. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| LabeledByProperty | Null |
Onay kutuları kendi kendine etiketleme denetimleridir. |
| LocalizedControlTypeProperty | "onay kutusu" | CheckBox denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Onay kutusu denetiminin Name özelliğinin değeri, iki durumlu düğme durumunu koruyan kutunun yanında görüntülenen metindir. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, tüm onay 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 |
|---|---|---|
| IToggleProvider | Zorunlu | Onay kutusunun program aracılığıyla iç durumları arasında geçiş yapmasına izin verir. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm onay kutusu denetimleri tarafından desteklenmesi 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 |
| ToggleStateProperty property-changed olayı. | Zorunlu | Hiçbiri |
Varsayılan Eylem
Onay kutusunun varsayılan eylemi, bir radyo düğmesinin odaklanıp geçerli durumunu değiştirmesine neden olmaktır. Daha önce belirtildiği gibi, onay kutuları kullanıcıya ikili (Evet/Hayır) (Açık/Kapalı) bir karar veya üçüncül (Açık, Kapalı, Belirsiz) sunar. Onay kutusu ikiliyse, varsayılan eylem "açık" durumunun "kapalı" veya "kapalı" durumunun "açık" olmasına neden olur. Üçüncül durumda onay kutusunda, varsayılan eylem, onay kutusunun durumları arasında, kullanıcının denetime ardışık fare tıklamaları göndermiş gibi aynı sırada döngü oluşturur.