Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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, DataItem denetim türü için Microsoft UI Otomasyonu desteği hakkında bilgi sağlar. UI Otomasyonu'nda denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması ControlTypeProperty gereken bir koşul kümesidir. Koşullar UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.
Kişiler listesindeki bir girdi, veri öğesi denetimine örnektir. Veri öğesi denetimi, son kullanıcının ilgilendiği bilgileri içerir. Daha zengin bilgiler içerdiğinden basit liste öğesinden daha karmaşıktır.
Aşağıdaki bölümlerde DataItem 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 veri öğesi denetimleri için geçerlidir.
Gerekli UI Otomasyon Ağaç Yapısı
Aşağıdaki tabloda, veri öğ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 Otomasyon Ağacına Genel Bakış.
| UI Otomasyon Ağacı - Denetim Görünümü | UI Otomasyon Ağacı - İçerik Görünümü |
|---|---|
| DataItem - Değişkenlik gösterir (0 veya daha fazla; hiyerarşide yapılandırılabilir) |
DataItem - Değişkenlik gösterir (0 veya daha fazla; hiyerarşide yapılandırılabilir) |
Veri kılavuzundaki veri öğesi öğesi, başka bir veri öğesi katmanı veya metin, görüntü veya düzenleme denetimleri gibi belirli kılavuz öğeleri de dahil olmak üzere çeşitli nesneleri barındırabilir. Veri öğesi öğesinin belirli bir nesne rolü varsa, öğe belirli bir denetim türü olarak gösterilmelidir; örneğin, kılavuzdaki seçilebilir bir veri öğesi için ListItem denetim türü.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle veri öğesi denetimleriyle ilgili olan özellikler listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için UI Otomasyonu Özellikleri.
| Mülkiyet | 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. | 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. |
| ControlTypeProperty | DataItem | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | Doğru | Veri öğesi denetimi her zaman içerik olmalıdır. |
| IsControlElementProperty | Doğru | Veri öğesi denetimi her zaman bir denetim olmalıdır. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| ItemStatusProperty | Notlara bakın. | Denetim dinamik olarak güncelleştirilen durumu içeriyorsa, yardımcı bir teknolojinin öğenin durumu değiştiğinde güncelleştirmeleri alabilmesi için bu özelliğin desteklenmesi gerekir. |
| ItemTypeProperty | Notlara bakın. | Bu, öğenin temsil ettiği temel nesneyi son kullanıcıya ileten dize değeridir. Örnek olarak "Medya Dosyası" veya "Kişi" verilebilir. |
| LabeledByProperty | Null |
Veri öğesi denetimlerinin statik metin etiketi yoktur. |
| LocalizedControlTypeProperty | "veri öğesi" | DataItem denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Veri öğesi denetimi her zaman kullanıcının öğe için en anlamsal tanımlayıcı olarak ilişkilendireceği öğeyle ilişkili bir birincil metin öğesi içerir. |
Gerekli Kullanıcı Arayüzü Otomasyonu Kontrol Desenleri
Aşağıdaki tabloda, tüm veri öğesi denetimleri tarafından desteklenmesi için gereken Microsoft 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 |
|---|---|---|
| IExpandCollapseProvider | Duruma bağlı. | Bilgileri göstermek ve gizlemek için veri öğesi genişletilebiliyor veya daraltılabiliyorsa Genişlet Daralt deseninin desteklenmesi gerekir. |
| IGridItemProvider | Duruma bağlı. | Veri öğeleri, uzamsal olarak öğeden öğeye gidilebilen bir kapsayıcıda veri öğeleri koleksiyonu mevcut olduğunda Izgara Öğesi modelini destekler. |
| IScrollItemProvider | Duruma bağlı. | Tüm veri öğeleri, veri kapsayıcılarında ekrana sığabilecek öğeden daha fazla öğe olduğunda Kaydırma Öğesi düzeniyle görünüme kaydırılma özelliğini destekler. |
| ISelectionItemProvider | Evet | Öğenin ne zaman seçildiğini belirtmek için tüm veri öğelerinin Seçim Öğesi desenini desteklemesi gerekir. |
| ITableItemProvider | Duruma bağlı. | Veri öğesi bir Data Grid denetim türünde yer alırsa bu deseni destekler. |
| IToggleProvider | Duruma bağlı. | Veri öğesi döngüye geçirilebilecek bir durum içeriyorsa. |
| IValueProvider | Duruma bağlı. | Veri öğesinin birincil metni düzenlenebilirse Değer deseninin desteklenmesi gerekir. |
Büyük Listelerdeki Veri Öğeleriyle Çalışma
Büyük listeler genellikle performansa yardımcı olmak için kullanıcı arabirimi çerçeveleri içinde sanallaştırılmış verilerdir. Bu nedenle, UI Otomasyonu istemcisi UI Otomasyonu sorgu özelliğini kullanarak tam ağacın içeriğini diğer öğe kapsayıcılarında olduğu gibi kazıyamaz. İstemci, veri öğesinden tam bilgi kümesine erişmeden önce öğeyi görünüme kaydırmalı (veya tüm değerli seçenekleri göstermek için denetimi genişletmelidir).
Veri öğesi için UI Otomasyonu öğesi üzerinde SetFocus çağrısı yapıldığında, Microsoft Windows Gezgini durumu başarıyla dönecek ve odağın veri öğesi alt ağacı içinde Düzenleme kontrolüne ayarlanmasına neden olacaktır.
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm veri öğesi 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 |
|---|---|---|
| AutomationFocusChangedEvent | Gerekli | Hiç kimse |
| BoundingRectangleProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsEnabledProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| IsOffscreenProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| NameProperty özellik değişikliği olayı. | Gerekli | Hiç kimse |
| StructureChangedEvent | Gerekli | Hiç kimse |
| InvokedEvent | Duruma bağlı. | Hiç kimse |
| ExpandCollapseStateProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
| ElementAddedToSelectionEvent | Gerekli | Hiç kimse |
| ElementRemovedFromSelectionEvent | Gerekli | Hiç kimse |
| ElementSelectedEvent | Gerekli | Hiç kimse |
| ToggleStateProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
| ValueProperty özellik değişikliği olayı. | Duruma bağlı. | Hiç kimse |
DataItem Denetim Türü Örneği
Aşağıdaki görüntü, bir Liste Görünümü denetiminde zengin bilgi içeren sütunları destekleyen bir DataItem denetim türünü göstermektedir.
Veri öğesi denetimiyle ilgili UI Otomasyonu ağacının Denetim Görünümü ve İçerik Görünümü aşağıda görüntülenir. Her otomasyon öğesinin denetim desenleri parantez içinde gösterilir. "Contoso" Grubu ayrıca Data Grid ana kontrolünün bir parçasıdır.
| UI Otomasyon Ağacı - Denetim Görünümü | UI Otomasyon Ağacı - İçerik Görünümü |
|---|---|
| - Grup "Contoso" (Tablo, Kılavuz) - DataItem "Hesaplar Alacaklar.doc" (TableItem, GridItem, SelectionItem, Invoke) - Resim "Hesaplar Alacaklar.doc" - "İsim" öğesini düzenle (Tablo Öğesi, Izgara Öğesi, Değer "Alacaklar.doc") - Düzenleme "Değiştirme tarihi" (TableItem, GridItem, Value "25/8/2006 15:29") - "Boyut"u Düzenle (GridItem, TableItem, Değer "11.0 KB) - DataItem "Accounts Payable.doc" (TabloÖğesi, IzgaraÖğesi, SeçimÖğesi, Çağır) - ... |
- Grup "Contoso" (Tablo, Kılavuz) - DataItem "Hesaplar Alacaklar.doc" (TableItem, GridItem, SelectionItem, Invoke) - Resim "Hesaplar Alacaklar.doc" - "İsim" öğesini düzenle (Tablo Öğesi, Izgara Öğesi, Değer "Alacaklar.doc") - Düzenleme "Değiştirme tarihi" (TableItem, GridItem, Value "25/8/2006 15:29") - "Boyut"u Düzenle (GridItem, TableItem, Değer "11.0 KB) - DataItem "Accounts Payable.doc" (TabloÖğesi, IzgaraÖğesi, SeçimÖğesi, Çağır) - … |
Bir kılavuz seçilebilir öğelerin listesini temsil ederse, ilgili kullanıcı arabirimi öğeleri DataItem denetim türü yerine ListItem denetim türüyle gösterilebilir. Yukarıdaki örnekte, Grup ("Contoso") altındaki DataItem öğeleri ("Hesaplar Receivable.doc" ve "Hesaplar Payable.doc") ListItem denetim türleri olarak gösterilerek geliştirilebilir çünkü bu tür SelectionItem denetim desenini zaten desteklemektedir.