Düğme Denetim Türü İç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 konuda, Düğme denetim türü için UI Otomasyonu desteği hakkında bilgi sağlanır. UI Otomasyonu denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidirControlTypeProperty. Koşullar arasında UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri, denetim desenleri ve UI Otomasyonu olayları için belirli yönergeler bulunur.
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üğme 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 düğme denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, düğme 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ğaca 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 |
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle Düğme denetim türünü uygulayan denetimler (düğme denetimleri gibi) ile 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 |
|---|---|---|
| AcceleratorKeyProperty | Notlara bakın. | Düğme denetimi genellikle son kullanıcının temsil ettiği eylemi klavyeden hızlı bir şekilde gerçekleştirmesini sağlamak için bir hızlandırıcı tuşunu desteklemelidir. |
| 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 | Düğme | Bu değer tüm ui çerçeveleri için aynıdır. |
| HelpTextProperty | Notlara bakın. | Yardım Metni, düğmeyi etkinleştirme işleminin sonunun ne olacağını gösterebilir. Bu genellikle Bir Araç İpucu aracılığıyla sunulan bilgilerle aynıdır. |
| IsContentElementProperty | True | Düğme denetimi her zaman içerik olmalıdır. |
| IsControlElementProperty | True | Düğme denetimi her zaman bir denetim olmalıdır. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| LabeledByProperty | Null |
Düğme denetimleri, içerikleri tarafından kendi kendine etiketlenir. |
| LocalizedControlTypeProperty | "düğme" | Düğme denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Düğme denetiminin adı, düğmeyi etiketlemek için kullanılan metindir. Bir düğmeyi etiketlemek için bir resim kullanıldığında, düğmenin Name özelliği için alternatif metin sağlanmalıdır. |
Gerekli UI Otomasyonu 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 | Destek | Notlar |
|---|---|---|
| IInvokeProvider | Notlara bakın. | Tüm düğmeler Invoke denetim desenini veya Geçiş denetimi desenini desteklemelidir. Düğme kullanıcının isteği üzerine bir komut gerçekleştirdiğinde Invoke desteklenir. 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ş denetimi desenini desteklemelidir. Düğme en fazla üç durumlu bir dizi boyunca döngüye alınabiliyorsa iki durumlu düğme desteklenir. Bu genellikle belirli özellikler için bir açma/kapatma düğmesi olarak görülür. |
| 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ğırma veya Geçiş düzeni yerine ExpandCollapse desenini destekleyebilir. ExpandCollapse deseni, düğme öğesiyle ilişkili bir menüyü veya diğer alt yapıyı açmak veya kapatmak için kullanılabilir. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm düğme 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 |
| NameProperty property-changed olayı. | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |
| InvokedEvent | -Sına bağ -lıdır | Denetim Invoke denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| ToggleStateProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Geçiş denetimi düzenini destekliyorsa bu olayı desteklemesi gerekir. |