Aracılığıyla paylaş


RadioButton Denetim Türü

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

Radyo düğmesi yuvarlak bir düğmeden ve uygulama tanımlı metinden (etiket), simgeden veya kullanıcının düğmeyi seçerek seçebileceği bir seçimi gösteren bit eşlemden oluşur. Uygulama genellikle bir grup kutusundaki radyo düğmelerini kullanarak kullanıcının birbiriyle ilişkili ancak birbirini dışlayan seçenekler arasından seçim yapmasına izin verir. Örneğin, uygulama kullanıcının istemci alanında seçilen metin için bir biçim tercihi seçebileceği bir radyo düğmeleri grubu sunabilir. Kullanıcı, ilgili radyo düğmesini seçerek sola hizalanmış, sağa hizalanmış veya ortalanmış bir biçim seçebilir. Genellikle, kullanıcı bir dizi radyo düğmesinden aynı anda yalnızca bir seçenek belirleyebilir.

Not

Grupta yalnızca birinin seçilebildiği düğmeler için bir diğer denetim genelleştirmesi de iki durumlu düğmenin içeriğidir. Bazı kullanıcı arabirimi çerçeveleri, bir radyo düğmesini özel bir geçiş düğmesi olarak kabul eder.

 

Aşağıdaki bölümlerde, RadioButton denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. 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 düğme denetimleri için geçerlidir.

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

Tipik Ağaç Yapısı

Aşağıdaki tabloda, radyo düğmesi 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ü
  • RadioButton
  • RadioButton

 

Denetim görünümünde veya içerik görünümünde alt öğe yok.

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle RadioButton denetim türünü (düğme denetimleri gibi) uygulayan denetimler ile 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. Tıklanabilir nokta, tıklandığında radyo düğmesini seçen bir nokta olmalıdır.
UIA_ControlTypePropertyId radiobutton
UIA_IsContentElementPropertyId DOĞRU Radyo düğmesi denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir.
UIA_IsControlElementPropertyId DOĞRU Radyo düğmesi denetimi her zaman UI Otomasyon ağacının denetim görünümüne eklenir.
UIA_IsKeyboardFocusablePropertyId Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir.
UIA_LabeledByPropertyId SIFIR Radyo düğmesi denetimleri, içerikleri tarafından kendi kendine etiketlenir.
UIA_LocalizedControlTypePropertyId Notlara bakın. RadioButton denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "radyo düğmesi"dir.
UIA_NamePropertyId Notlara bakın. Radyo düğmesi denetiminin adı, seçim durumunu koruyan düğmenin yanında görüntülenen metindir.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, tüm radyo düğmesi 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/Desen Özelliği Destek/Değer Notlar
ISelectionItemProvider Gerekli Tüm radyo düğmesi denetimleri, kendilerinin seçilmesini sağlamak için SelectionItem denetim desenini desteklemelidir.
SelectionContainer Notlara bakın. SelectionContainer özelliği, ui Otomasyonu istemcisinin belirli bir bağlamdaki diğer radyo düğmelerini birbiriyle ilişkilendirebilmesi için her zaman tamamlanmalıdır. Radyo düğmesinin Microsoft Win32 sürümü için, bu eski çerçeveden bu bilgileri almak mümkün olmadığından bu özellik desteklenmez.
IToggleProvider Hiç Radyo düğmesi ayarlandıktan sonra durumu arasında geçiş yapamaz. Geçiş denetim düzeni hiçbir zaman radyo düğmesinde desteklenmemelidir.

 

Gerekli Olaylar

Aşağıdaki tabloda, düğme 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_SelectionItem_ElementRemovedFromSelectionEventId Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_SelectionItem_ElementSelectedEventId Denetim SelectionItem denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
UIA_StructureChangedEventId

 

Açıklamalar

Radyo düğmesi, eş radyo düğmeleri arasında tek bir seçilebilir seçeneği temsil eder. İdeal olarak, radyo düğmelerinin eş radyo düğmelerinin sınırlarını belirten bir gruplandırma öğesi olmalıdır. Ancak genellikle, sınır kullanıcı arabirimi öğesi yapısı tarafından örtülür. Örneğin, bir menü, menü öğeleri yerine ardışık radyo düğmeleri kümesi veya grup etiketinden sonra, ancak düğme gibi eyleme dönüştürülebilir bir öğeden önce gerçekleşen bir dizi radyo düğmesi içerebilir.

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış