Aracılığıyla paylaş


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.

Ayrıca bkz.