DataGrid 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, DataGrid denetim türü için Microsoft 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ümesidirControlType
. Koşullar, UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.
DataGrid denetim türü, kullanıcının sütunlarda temsil edilen meta verileri içeren öğelerle kolayca çalışmasını sağlar. Veri kılavuzu denetimleri, söz konusu öğelerle ilgili bilgi satırlarını ve sütunlarını içerir. Microsoft Vista Gezgini'ndeki Liste Görünümü denetimi, DataGrid denetim türünü destekleyen bir örnektir.
Aşağıdaki bölümlerde DataGrid 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 kılavuzu denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, veri kılavuzu 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ış.
UI Otomasyonu Ağacı - Denetim Görünümü | UI Otomasyonu Ağacı - İçerik Görünümü |
---|---|
DataGrid
|
DataGrid - DataItem (0 veya daha fazla; hiyerarşide yapılandırılabilir) |
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle veri kılavuzu denetimleriyle ilgili olan özellikler listelenmektedir. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.
Özellik | 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 | DataGrid | Bu değer tüm ui çerçeveleri için aynıdır. |
IsContentElementProperty | True | Bu özelliğin değeri her zaman True olmalıdır. Bu, veri kılavuzu denetiminin her zaman UI Otomasyonu ağacının içerik görünümünde olması gerektiği anlamına gelir. |
IsControlElementProperty | True | Bu özelliğin değeri her zaman True olmalıdır. Bu, veri kılavuzu denetiminin her zaman UI Otomasyonu ağacının denetim görünümünde olması gerektiği anlamına gelir. |
IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
LabeledByProperty | Notlara bakın. | Statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. |
LocalizedControlTypeProperty | "veri kılavuzu" | DataGrid denetim türüne karşılık gelen yerelleştirilmiş dize. |
NameProperty | Notlara bakın. | Veri kılavuzu denetimi genellikle özelliğinin değerini Name statik bir metin etiketinden alır. Statik metin etiketi yoksa, uygulama geliştiricisinin özelliği için değerine ataması Name gerekir. özelliğinin Name değeri hiçbir zaman düzenleme denetiminin metin içeriği olmamalıdır. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, tüm veri kılavuzu denetimleri tarafından desteklenmesi için gereken denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.
Denetim Deseni | Destek | Notlar |
---|---|---|
IGridProvider | Yes | Veri kılavuzu denetiminin kendisi her zaman Kılavuz denetim desenini destekler çünkü içindeki öğeler bir kılavuzda yerleştirilmiş meta veriler içerir. |
IScrollProvider | -Sına bağ -lıdır | Veri kılavuzunu kaydırma özelliği, içeriğe ve kaydırma çubuklarının mevcut olup olmamasına bağlıdır. |
ISelectionProvider | -Sına bağ -lıdır | Veri kılavuzunu seçebilme özelliği içeriğe bağlıdır. |
ITableProvider | Yes | Veri kılavuzu denetiminin her zaman alt ağacı içinde bir üst bilgi vardır, bu nedenle Tablo denetim deseninin desteklenmesi gerekir. |
Veri kılavuzu kapsayıcıları içindeki veri öğeleri en az şunları destekler:
Seçim Öğesi denetim düzeni (veri kılavuzu seçilebilirse)
Kaydırma Öğesi denetim düzeni (veri kılavuzu kaydırılabilirse)
Kılavuz Öğesi denetim düzeni
Tablo Öğesi denetim deseni
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm veri kılavuzu 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 |
---|---|---|
AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
LayoutInvalidatedEvent | -Sına bağ -lıdır | Hiçbiri |
StructureChangedEvent | Zorunlu | Hiçbiri |
CurrentViewProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
HorizontallyScrollableProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
HorizontalScrollPercentProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
HorizontalViewSizeProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
VerticalScrollPercentProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
VerticallyScrollableProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
VerticalViewSizeProperty property-changed olayı. | -Sına bağ -lıdır | Denetim Kaydırma düzenini destekliyorsa bu olayı desteklemesi gerekir. |
InvalidatedEvent | Zorunlu | Hiçbiri |
Tarih Kılavuzu Denetim Türü Örneği
Aşağıdaki görüntüde DataGrid denetim türünü uygulayan bir Liste Görünümü denetimi gösterilmektedir.
Liste Görünümü denetimiyle ilgili UI Otomasyonu ağacının denetim görünümü ve içerik görünümü aşağıda görüntülenir. Her otomasyon öğesinin denetim desenleri parantez içinde gösterilir.
UI Otomasyonu Ağacı - Denetim Görünümü | UI Otomasyonu Ağacı - İçerik Görünümü |
---|---|
|
|
* Önceki örnekte, birden çok denetim düzeyi içeren bir DataGrid gösterilmektedir. Grup ("Contoso") denetimi iki DataItem denetimi ("Hesaplar Receivable.doc" ve "Hesaplar Payable.doc") içerir. DataGrid/GridItem çifti, başka bir düzeydeki bir çiftten bağımsızdır. Bir Grup altındaki DataItem denetimleri de ListItem denetim türü olarak gösterilebilir ve bu sayede basit veri öğeleri olarak değil, seçilebilir nesneler olarak daha net bir şekilde sunulabilir. Bu örnek, gruplandırılmış veri öğelerinin alt öğelerini içermez.