Aracılığıyla paylaş


MenuItem 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, MenuItem denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar. Denetimin Microsoft UI Otomasyonu ağaç yapısını açıklar ve MenuItem denetim türü için gereken özellikleri ve denetim desenlerini sağlar.

Menü denetimi, komutlar ve olay işleyicileriyle ilişkili öğelerin hiyerarşik olarak düzenlenmesine olanak tanır. Tipik bir Microsoft Windows uygulamasında, menü çubuğunda çeşitli menü öğeleri (Dosya, Düzenle ve Pencere gibi) bulunur ve her menü öğesi bir menü görüntüler. Menü, ek menü öğelerini görüntülemek veya tıklandığında belirli bir eylemi gerçekleştirmek için genişletilebilen bir menü öğeleri koleksiyonu (Yeni, ve Kapat gibi) içerir. Menü öğesi bir menüde, menü çubuğunda veya araç çubuğunda barındırılabilir.

Aşağıdaki bölümlerde MenuItem 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 liste denetimleri için geçerlidir.

Gerekli UI Otomasyonu Ağaç Yapısı

Aşağıdaki tabloda, menü öğesi 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ü
MenuItem "Yardım"

  • Menü (Yardım menü öğesinin alt menüsü)

    • MenuItem "Yardım Konuları"
    • MenuItem "Not Defteri Hakkında"
MenuItem "Yardım"

- MenuItem "Yardım Konuları"
- MenuItem "Not Defteri Hakkında"

Menü öğesi denetiminin denetim görünümü, yukarıda gösterilen UI Otomasyonu ağaç yapısına sahiptir. Tipik bir menüdeki alt menü hiyerarşisindeki yapıyı daha iyi göstermek için Yardım menü öğesinin eklendiğini unutmayın.

İçerik görünümünde Menü, son kullanıcıya anlamlı bilgiler iletmediğinden UI Otomasyonu ağacında yok.

Gerekli UI Otomasyonu Özellikleri

Aşağıdaki tabloda, değeri veya tanımı özellikle menü öğesi denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.

Özellik Değer Açıklama
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.
IsKeyboardFocusableProperty Notlara bakın. Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir.
NameProperty Notlara bakın. Menü öğesi denetimi, UI Otomasyonu ağacının içerik görünümünde yer alır ve kendi kendine bir adla etiketlenmiştir.
LabeledByProperty Null Etiket yok.
ControlTypeProperty MenuItem Bu değer tüm ui çerçeveleri için aynıdır.
LocalizedControlTypeProperty "menü öğesi" MenuItem denetim türüne karşılık gelen yerelleştirilmiş dize.
IsContentElementProperty True Menü öğesi denetimi hiçbir zaman UI Otomasyonu ağacının içerik görünümüne dahil değildir.
IsControlElementProperty True Menü öğesi denetimi her zaman UI Otomasyonu ağacının denetim görünümüne dahil edilmelidir.

Gerekli UI Otomasyonu Denetim Desenleri

Aşağıdaki tabloda, menü öğesi 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 Özelliği Destek Notlar
IExpandCollapseProvider -Sına bağ -lıdır Denetim genişletilebilir veya daraltılabilirse uygulayın IExpandCollapseProvider.
IInvokeProvider -Sına bağ -lıdır Denetim tek bir eylem veya komut yürütürse uygulayın IInvokeProvider.
IToggleProvider -Sına bağ -lıdır Denetim açılabilir veya kapatılabilir bir seçeneği temsil ederse uygulayın IToggleProvider.
ISelectionItemProvider -Sına bağ -lıdır Denetim, menü öğeleri arasındaki seçenekler listesinden seçim yapmak için kullanılıyorsa uygulayın ISelectionItemProvider.

Menü Öğesi için olayları UI Otomasyonu

Aşağıdaki tabloda, menü öğesi denetimiyle ilişkili Microsoft UI Otomasyonu olayları listelanmaktadır.

Etkinlik Destek Açıklama
InvokedEvent -Sına bağ -lıdır Denetim Invoke denetim deseni destekliyorsa tetiklenmelidir.
ToggleStateProperty property-changed olayı. -Sına bağ -lıdır Denetim Geçiş denetimi düzenini destekliyorsa yükseltilmelidir.
ExpandCollapseStateProperty property-changed olayı. -Sına bağ -lıdır Denetim Genişlet Daralt denetim düzenini destekliyorsa tetiklenmelidir.
ElementSelectedEvent -Sına bağ -lıdır Yok.

Gerekli UI Otomasyonu Olayları

Aşağıdaki tabloda, tüm menü öğesi 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/Değer Notlar
InvokedEvent -Sına bağ -lıdır Hiçbiri
ElementAddedToSelectionEvent -Sına bağ -lıdır Hiçbiri
ElementRemovedFromSelectionEvent -Sına bağ -lıdır Hiçbiri
ElementSelectedEvent -Sına bağ -lıdır Hiçbiri
BoundingRectangleProperty property-changed olayı. Zorunlu Hiçbiri
IsOffscreenProperty property-changed olayı. Zorunlu Hiçbiri
IsEnabledProperty property-changed olayı. Zorunlu Hiçbiri
ExpandCollapseStateProperty property-changed olayı. -Sına bağ -lıdır Hiçbiri
ToggleStateProperty property-changed olayı. -Sına bağ -lıdır Hiçbiri
AutomationFocusChangedEvent Zorunlu Hiçbiri
StructureChangedEvent Zorunlu Hiçbiri

Eski Sorunlar

Geçiş Düzeni yalnızca Win32 menü öğesi işaretlendiğinde desteklenir ve Geçiş Düzeni'ni desteklemek için program aracılığıyla gerekli olarak belirlenebilir. Win32 menü öğesi denetlenme özelliği olup olmadığını göstermediğinden, menü öğesi işaretlenmediğinde Çağırma Düzeni desteklenir. Yalnızca Geçiş Deseni'nin desteklenmesi gereken menü öğeleri için bile Her Zaman Çağırma Deseni'nin desteklenmesi için bir özel durum oluşturulur. Bu, istemcilerin Çağırma Desenini destekleyen bir öğenin (menü öğesi işaretlenmediğinde) işaretlendikten sonra deseni desteklememesi için karıştırılmaz.

Ayrıca bkz.