Görüntü 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 konu başlığında, Görüntü 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, UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.
Simgeler, bilgilendirme grafikleri ve grafikler olarak kullanılan görüntü denetimleri, Görüntü denetim türünü destekler. Arka plan veya filigran görüntüleri olarak kullanılan denetimler, Görüntü denetim türünü desteklemez.
Aşağıdaki bölümler, Görüntü denetim türü için gerekli UI Otomasyonu ağaç yapısını, özelliklerini, denetim desenlerini ve olaylarını tanımlar. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm görüntü denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, görüntü 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ü |
|---|---|
| Görsel | Görüntü (Görüntünün bilgi içerip içermediğine bağlıdır (özelliğin IsContentElement değerine göre)) |
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle Görüntü denetim türüyle 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 |
|---|---|---|
| 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. | Görüntü denetiminin tıklanabilir noktası, görüntü denetiminin sınırlayıcı dikdörtgeni içinde bir nokta olmalıdır. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| NameProperty | Notlara bakın. | Name özelliği, bilgi içeren tüm görüntü denetimleri için kullanıma sunulmalıdır. Bu bilgilere programlı erişim, grafiğe eşdeğer bir metinsel değer sağlanmasını gerektirir. Görüntü denetimi tamamen dekoratifse, yalnızca UI Otomasyonu ağacının denetim görünümünde görünmelidir ve bir ada sahip olması gerekmez. UI çerçeveleri, çerçeveleri içinden ayarlanabilen görüntülerde ALT veya alternatif metin özelliğini desteklemelidir. Bu özellik daha sonra UI Otomasyonu Name özelliğine eşlenir. |
| LabeledByProperty | Notlara bakın. | Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. |
| ControlTypeProperty | Görsel | Bu değer tüm ui çerçeveleri için aynıdır. |
| LocalizedControlTypeProperty | "resim" | Görüntü denetim türüne karşılık gelen yerelleştirilmiş dize. |
| IsContentElementProperty | Notlara bakın. | Görüntü denetimi, son kullanıcıya açık olmayan anlamlı bilgiler içerdiğinde UI Otomasyonu ağacının içerik görünümüne eklenmelidir. |
| IsControlElementProperty | True | Görüntü denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| HelpTextProperty | Notlara bakın. | HelpText özelliği, denetimin gerçek görsel görünümünü (örneğin, beyaz 'X' içeren kırmızı bir kare) veya görüntüyle ilişkili diğer araç ipucu bilgilerini açıklayan yerelleştirilmiş bir dizeyi kullanıma sunar. Görüntü denetimi hakkında daha fazla bilgi iletmek için uzun bir açıklama gerektiğinde bu özellik desteklenmelidir. Örneğin, karmaşık bir grafik veya diyagram. Bu özellik HTML LongDesc etiketiyle ve Ölçeklenebilir Vektör Grafikleri (SVG) Desc etiketiyle eşler. Görüntü denetimleriyle çalışan geliştiricilerin, denetimde görsel açıklamasının ayarlanmasına izin vermek için bir özelliği desteklemesi gerekir. Bu özellik UI Otomasyonu VisualDescription özelliğine eşlenmelidir. |
| ItemStatusProperty | Notlara bakın. | Görüntü denetimi ekrandaki belirli bir öğeyle ilgili durum bilgilerini temsil ediyorsa, denetim öğenin içinde yer almalıdır. Görüntü bir öğenin içinde bulunduğunda öğenin durum özelliğini desteklemesi ve durum değiştiğinde uygun bildirimleri göndermesi gerekir. Bir görüntü tek başına bir denetimse ve durumu aktarıyorsa bu özellik desteklenmelidir. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, tüm görüntü 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 |
|---|---|---|
| IGridItemProvider | -Sına bağ -lıdır | Denetim bir kılavuz kapsayıcısı içindeyse, görüntü denetimi Kılavuz Öğesi desenini destekler. |
| ITableItemProvider | -Sına bağ -lıdır | Denetim üst bilgi denetimlerine sahip bir kapsayıcının içindeyse, görüntü denetimi Tablo Öğesi düzenini destekler. |
| IInvokeProvider | Asla | Görüntü denetimi tıklanabilir bir görüntü içeriyorsa, denetim Düğme denetim türü gibi Invoke desenini destekleyen bir denetim türünü desteklemelidir. |
| ISelectionItemProvider | Asla | Görüntü denetimleri Seçim Öğesi desenini desteklememelidir. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda tüm görüntü 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 |
|---|---|---|
| InvokedEvent | Asla | Hiçbiri |
| ElementAddedToSelectionEvent | Asla | Hiçbiri |
| ElementRemovedFromSelectionEvent | Asla | Hiçbiri |
| ElementSelectedEvent | Asla | 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 |
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |