Aracılığıyla paylaş

Görüntü Denetim Türü için UI Otomasyonu Desteği

Uyarı

Bu belgeler, System.Windows.Automation ad alanında tanımlanan yönetilen UI Otomasyonu sınıflarını kullanmak isteyen .NET Framework geliştiricilerine yöneliktir. UI Otomasyonu hakkında en son bilgiler için bkz. Windows Otomasyonu API'si: UI Otomasyonu.

Bu konu, Görüntü denetim türü için UI Otomasyonu desteği hakkında bilgi sağlar. UI Otomasyonu'nda denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidir ControlTypeProperty . 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ümlerde Görüntü 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 görüntü denetimleri için geçerlidir.

Gerekli UI Otomasyon 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ğ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ü
Resim 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 UI Otomasyonu Özellikleri.

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 Adı ö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 Resim 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 Doğru 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 etiketi ve Ölçeklenebilir Vektör Grafikleri (SVG) Desc etiketi ile eşleşir. 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 Kullanıcı Arayüzü Otomasyonu Kontrol 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 Duruma bağlı. Denetim bir kılavuz kapsayıcısı içindeyse, görüntü denetimi Kılavuz Öğesi desenini destekler.
ITableItemProvider Duruma bağlı. Görüntü denetimi, üst bilgi denetimlerine sahip bir kapsayıcının içinde bulunuyorsa Tablo Öğesi düzenini destekler.
IInvokeProvider Hiç 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 Hiç 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 için gereken UI Otomasyonu olayları listelenmektedir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.

UI Otomasyonu Olayı Destek Notlar
InvokedEvent Hiç Hiç kimse
ElementAddedToSelectionEvent Hiç Hiç kimse
ElementRemovedFromSelectionEvent Hiç Hiç kimse
ElementSelectedEvent Hiç Hiç kimse
BoundingRectangleProperty özellik değişikliği olayı. Gerekli Hiç kimse
IsOffscreenProperty özellik değişikliği olayı. Gerekli Hiç kimse
IsEnabledProperty özellik değişikliği olayı. Gerekli Hiç kimse
NameProperty özellik değişikliği olayı. Gerekli Hiç kimse
AutomationFocusChangedEvent Gerekli Hiç kimse
StructureChangedEvent Gerekli Hiç kimse

Ayrıca bakınız