Aracılığıyla paylaş

Düğme Denetim Türü

  • Makale

Bu konuda, Düğmesi denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlanır.

Düğme, kullanıcının iletişim kutusundaki Tamam ve İptal düğmeleri gibi bir eylem gerçekleştirmek için etkileşimde olduğu bir nesnedir. Düğme denetimi, kullanıcının tamamlamak istediği tek bir komutla eşlendiğinden kullanıma sunulan basit bir denetimdir.

Aşağıdaki bölümlerde, Düğmesi 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, düğme denetimleriyle ilgili kullanıcı arabirimi 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ü
  • Düğme
    • Görüntü (0 veya daha fazla)
    • Metin (0 veya daha fazla)
  • Düğme

 

İlgili Özellikler

Aşağıdaki tabloda, değeri veya tanımı özellikle Düğmesi 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_AcceleratorKeyPropertyId Notlara bakın. Düğme denetimi genellikle son kullanıcının klavyeden düğmeyle temsil edilen eylemi hızlı bir şekilde gerçekleştirmesini sağlamak için bir hızlandırıcı tuşunu destekler.
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. Sınırlayıcı bir dikdörtgen varsa desteklenir. Sınırlayıcı dikdörtgenin içindeki her nokta tıklanabilir değilse ve öğesi özel isabet testi gerçekleştiriyorsa, geçersiz kılın ve tıklanabilir bir nokta sağlayın.
UIA_ControlTypePropertyId Düğmesi
UIA_HelpTextPropertyId Notlara bakın. Yardım metni, düğmeyi etkinleştirme işleminin sonunun ne olacağını göstermelidir. Bu genellikle bir araç ipucu aracılığıyla sunulan bilgilerle aynıdır.
UIA_IsContentElementPropertyId DOĞRU Düğme denetimi her zaman içerik olmalıdır.
UIA_IsControlElementPropertyId DOĞRU Düğme denetimi her zaman bir denetim olmalıdır.
UIA_IsKeyboardFocusablePropertyId Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir.
UIA_LabeledByPropertyId Sıfır Düğme denetimleri, içerikleri tarafından kendi kendine etiketlenir.
UIA_LocalizedControlTypePropertyId Notlara bakın. Düğmesi denetim türüne karşılık gelen yerelleştirilmiş dize. varsayılan değer, en-US veya İngilizce (ABD) için "düğme"dir.
UIA_NamePropertyId Notlara bakın. Düğme denetiminin adı, onu etiketlemek için kullanılan metindir. Bir düğmeyi etiketlemek için bir resim kullanıldığında, düğmenin Ad özelliği için alternatif metin sağlanmalıdır.

 

Gerekli Denetim Desenleri

Aşağıdaki tabloda, tüm düğme 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
IExpandCollapseProvider Notlara bakın. Bir düğme bölünmüş bir düğmenin alt öğesi olarak barındırıldığında, alt düğme Çağır veya Geçiş denetim deseni yerine ExpandCollapse denetim desenini destekleyebilir. ExpandCollapse denetim düzeni, düğme öğesiyle ilişkili bir menüyü veya diğer alt yapıyı açmak veya kapatmak için kullanılabilir.
IInvokeProvider Notlara bakın. Tüm düğmeler Invoke denetim desenini veya Geçiş denetim desenini desteklemelidir ancak ikisini birden desteklememelidir. Düğme kullanıcının isteği üzerine bir komut gerçekleştirdiğinde Invoke denetim düzeni desteklenmelidir. Bu komut Kes, Kopyala, Yapıştır veya Sil gibi tek bir işlemle eşler.
IToggleProvider Notlara bakın. Tüm düğmeler Invoke denetim desenini veya Geçiş denetim desenini desteklemelidir ancak ikisini birden desteklememelidir. Düğme en fazla üç durumlu bir dizi arasında geçiş yapabilirse Geçiş denetimi deseni desteklenmelidir. Bu genellikle belirli özellikler için bir açma/kapatma düğmesi olarak görülür.

 

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.
UIA_Invoke_InvokedEventId Denetim Invoke denetim desenini destekliyorsa, bu olayı desteklemesi gerekir.
ö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.
özelliği değiştirilmiş olayı UIA_NamePropertyId.
UIA_StructureChangedEventId
özelliği değiştirilmiş olayı UIA_ToggleToggleStatePropertyId. Denetim Geçiş denetim desenini destekliyorsa bu olayı desteklemesi gerekir.

 

kavramsal

UI Otomasyonu Denetim Türlerine Genel Bakış

UI Otomasyonuna Genel Bakış