Aracılığıyla paylaş


UI Otomasyonu Izgara Denetimi Desenini Gerçekleştirme

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 başlığında özellikler, yöntemler ve olaylar hakkında bilgiler de dahil olmak üzere IGridProvideruygulamaya yönelik yönergeler ve kurallar tanıtılmaktadır. Ek kaynakların bağlantıları, genel bakışın sonunda listelenir.

GridPattern kontrol düzeni, bir alt öğe koleksiyonu için kapsayıcı olarak işlev gören denetimleri desteklemek amacıyla kullanılır. Bu öğenin alt öğeleri IGridItemProvider uygulamalı ve satır ve sütunlarla geçilebilen iki boyutlu mantıksal bir koordinat sistemine göre düzenlenmelidir. Bu denetim desenini uygulayan denetim örnekleri için bkz. UI Automation İstemcileri için Denetim Deseni Eşlemesi.

Uygulama Yönergeleri ve Kuralları

Kılavuz denetimi desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:

  • Kılavuz koordinatları, koordinatlara (0, 0) sahip sol üst (veya yerel ayara bağlı olarak sağ üst hücre) ile sıfır tabanlıdır.

  • Bir hücre boş olsa bile, o hücrenin özelliğini desteklemek için bir UI Otomasyonu öğesinin yine de döndürülmesi gerekir. Kılavuzdaki alt öğelerin düzeni düzensiz bir diziye benzerse bu mümkündür (aşağıdaki örneğe bakın).

Düzensiz düzeni gösteren Windows Gezgini görünümü. Boş Koordinatları Olan Kılavuz Denetimi Örneği

  • Mantıksal olarak bir kılavuz kabul ediliyorsa, tek bir öğe içeren bir kılavuzu yine de IGridProvider uygulamak gerekir. Kılavuzdaki alt öğelerin sayısı önemsizdir.

  • Sağlayıcı uygulamasına bağlı olarak, gizli satırlar ve sütunlar UI Otomasyonu ağacına yüklenebilir ve bu nedenle RowCount ve ColumnCount özelliklerinde yansıtılabilirler. Gizli satırlar ve sütunlar henüz yüklenmediyse, bunlar sayılmamalıdır.

  • IGridProvider bir kılavuzun etkin işlemesini etkinleştirmez; ITransformProvider bu işlevi etkinleştirmek için uygulanmalıdır.

  • Hücrelerin eklenmesi, kaldırılması veya birleştirilmesi gibi ızgarada yapılan yapısal veya düzen değişikliklerini algılamak için bir StructureChangedEventHandler kullanın.

  • Öğeler veya hücreler arasında dolaşmayı izlemek için bir AutomationFocusChangedEventHandler kullanın.

IGridProvider için Gerekli Üyeler

IGridProvider arabirimini uygulamak için aşağıdaki özellikler ve yöntemler gereklidir.

Gerekli üyeler Türü Notlar
RowCount Mülkiyet Hiç kimse
ColumnCount Mülkiyet Hiç kimse
GetItem Yöntem Hiç kimse

Bu denetim deseninde ilişkili olay yok.

Özel durumlar

Sağlayıcılar, aşağıdaki özel durumları fırlatmalıdır.

Özel durum türü Koşul
ArgumentOutOfRangeException GetItem

- İstenen satır koordinatı RowCount değerinden büyükse veya sütun koordinatı ColumnCount değerinden büyükse.
ArgumentOutOfRangeException GetItem

- İstenen satır veya sütun koordinatlarından biri sıfırdan küçükse.

Ayrıca bakınız