Aracılığıyla paylaş


CheckBox Denetim Türü için UI Otomasyonu Desteği

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, CheckBox denetim türü için Microsoft 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.

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 Otomasyon 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 Otomasyon Ağacına Genel Bakış.

Denetim Görünümü İçerik Görünümü
Onay Kutusu Onay Kutusu

Uyarı

Onay kutuları hiçbir zaman kontrol veya içerik görünümünde alt öğelere sahip olmaz. Denetimin çocuk öğeler içermesi gerekiyorsa, bu durumda başka bir denetim türü kullanılmalıdır.

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 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.
ControlTypeProperty Onay Kutusu Bu değer tüm ui çerçeveleri için aynıdır.
IsContentElementProperty Doğru 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 eklenmesi gerektiği anlamına gelir.
IsControlElementProperty Doğru 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 seçim 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, kutunun yanına görüntülenen ve geçiş durumunu koruyan metindir.

Gerekli Kullanıcı Arayüzü Otomasyonu Kontrol 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 Gerekli 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 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
AutomationFocusChangedEvent 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
StructureChangedEvent Gerekli Hiç kimse
ToggleStateProperty özellik değişikliği olayı. Gerekli Hiç kimse

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 bir durumda onay kutusunda, varsayılan eylem, kullanıcının denetime ardışık fare tıklamaları göndermiş gibi, onay kutusunun durumları arasında aynı sırayla döngü yapar.

Ayrıca bakınız