ListItem 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, denetim türü için ListItem UI Otomasyonu desteği hakkında bilgi sağlar. 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.
Liste öğesi denetimleri, ListItem denetim türünü uygulayan bir denetim örneğidir.
Aşağıdaki bölümlerde ListItem 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, öğe denetimlerini listelemeyle 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ü |
|---|---|
| Listıtem - Görüntü (0 veya daha fazla) - Metin (0 veya daha fazla) - Düzenle (0 veya daha fazla) |
Listıtem |
UI Otomasyonu ağacının içerik görünümündeki liste öğesi denetiminin alt öğeleri her zaman "0" olmalıdır. Denetimin yapısı liste öğesinin altında başka öğeler yer alıyorsa TreeItem Denetim Türü denetim türü için UI Otomasyonu Desteği gereksinimlerini karşılamalıdır.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle liste öğ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.
| 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. | Bu özelliğin bu değeri, resim alanını ve liste öğesinin metin içeriğini içermelidir. |
| ClickablePointProperty | -Sına bağ -lıdır | Liste denetiminin tıklanabilir bir noktası varsa (listenin odaklanmasına neden olmak için tıklanabilen bir nokta) bu nokta bu özellik aracılığıyla gösterilmelidir. Liste denetimi alt liste öğeleri tarafından tamamen kapsanırsa, istemcinin liste denetimindeki bir öğeden tıklanabilir bir nokta istemesi gerektiğini belirtmek için bir oluşturur NoClickablePointException . |
| NameProperty | Notlara bakın. | Liste öğesi denetiminin ad özelliğinin değeri öğenin metin içeriğinden gelir. |
| LabeledByProperty | Notlara bakın. | Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. |
| ControlTypeProperty | Listıtem | Bu değer tüm ui çerçeveleri için aynıdır. |
| LocalizedControlTypeProperty | "liste öğesi" | ListItem denetim türüne karşılık gelen yerelleştirilmiş dize. |
| IsContentElementProperty | True | Liste denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | Liste denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| IsKeyboardFocusableProperty | True | Kapsayıcı klavye girişini kabul edebilirse bu özellik değeri true olmalıdır. |
| HelpTextProperty | "" | Liste denetimleri için Yardım metni, kullanıcıdan neden seçenek listesinden seçim yapmasının istendiği açıklanmalıdır. Bu, genellikle araç ipucu aracılığıyla sunulan bilgi türüyle aynıdır. Örneğin, "Monitörünüzün ekran çözünürlüğünü ayarlamak için bir öğe seçin." |
| ItemTypeProperty | -Sına bağ -lıdır | Bu özellik, temel alınan nesneyi temsil eden liste öğesi denetimleri için kullanıma sunulmalıdır. Bu liste öğesi denetimleri genellikle kullanıcıların temel alınan nesneyle ilişkilendirilen denetimle ilişkilendirilmiş bir simgeye sahiptir. |
| IsOffscreenProperty | -Sına bağ -lıdır | Bu özellik, liste öğesinin şu anda Kaydırma denetim deseni uygulayan üst kapsayıcı içinde görünüme kaydırılıp kaydırılmadığı için bir değer döndürmelidir. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda liste öğ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 | Destek | Notlar |
|---|---|---|
| ISelectionItemProvider | Yes | Liste öğesi denetiminin bu denetim düzenini uygulaması gerekir. Bu, liste öğeleri denetimlerinin seçildiklerinde iletmesine olanak tanır. |
| IScrollItemProvider | -Sına bağ -lıdır | Liste öğesi kaydırılabilir bir kapsayıcının içinde yer alıyorsa bu denetim deseninin uygulanması gerekir. |
| IToggleProvider | -Sına bağ -lıdır | Liste öğesi denetlenebilirse ve eylem bir seçim durumu değişikliği gerçekleştirmiyorsa, bu denetim deseninin uygulanması gerekir. |
| IExpandCollapseProvider | -Sına bağ -lıdır | Öğe bilgileri göstermek veya gizlemek için değiştirilebilirse, bu denetim düzeni uygulanmalıdır. |
| IValueProvider | -Sına bağ -lıdır | Öğe düzenlenebiliyorsa bu denetim düzeni uygulanmalıdır. Liste öğesi denetiminde yapılan değişiklikler, ve Valuedeğerlerinde NamePropertydeğişikliklere neden olur. |
| IGridItemProvider | -Sına bağ -lıdır | Öğeden öğeye uzamsal gezinti liste kapsayıcısı içinde destekleniyorsa ve kapsayıcı satırlar ve sütunlar halinde düzenlenmişse Kılavuz Öğesi denetim düzeni uygulanmalıdır. |
| IInvokeProvider | -Sına bağ -lıdır | Öğenin üzerinde seçimden ayrı olarak gerçekleştirilebilecek bir komutu varsa, bu desen uygulanmalıdır. Bu genellikle liste öğesi denetimine çift tıklamayla ilişkili bir eylemdir. Örnek olarak Microsoft Windows Gezgini'nden bir belge başlatma veya Microsoft Windows Medya Oynatıcı'de bir müzik dosyası çalma verilebilir. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm liste öğ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 | Notlar |
|---|---|---|
| InvokedEvent | -Sına bağ -lıdır | Hiçbiri |
| ElementAddedToSelectionEvent | Zorunlu | Hiçbiri |
| ElementRemovedFromSelectionEvent | Zorunlu | Hiçbiri |
| ElementSelectedEvent | 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 | Zorunlu | Hiçbiri |
| ItemStatusProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| ExpandCollapseStateProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| ValueProperty 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 |