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, Aç 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"
|
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.