UI Otomasyon Kılavuz Denetim Düzenini Uygulama

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

Denetim GridPattern düzeni, bir alt öğe koleksiyonu için kapsayıcı görevi üstleyen denetimleri desteklemek için kullanılır. Bu öğenin alt öğeleri, satır ve sütun tarafından geçirilebilen iki boyutlu bir mantıksal koordinat sisteminde uygulanıp IGridItemProvider düzenlenmelidir. Bu denetim desenini uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Düzeni 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.

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

Windows Explorer view showing ragged layout. Boş Koordinatları Olan Kılavuz Denetimi Örneği

  • Mantıksal olarak bir kılavuz olarak kabul edilirse tek bir öğe içeren bir kılavuz yine de uygulamak IGridProvider için gereklidir. 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 ve ColumnCount özelliklerine RowCount yansıtılır. 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.

  • Eklenen, kaldırılan veya birleştirilen hücreler gibi kılavuzda yapılan yapısal veya düzen değişikliklerini dinlemek için bir StructureChangedEventHandler kullanın.

  • AutomationFocusChangedEventHandler Kılavuzun öğeleri veya hücreleri arasında dolaşmayı izlemek için 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 Özellik Hiçbiri
ColumnCount Özellik Hiçbiri
GetItem Metot Hiçbiri

Bu denetim deseninde ilişkili olay yok.

Özel durumlar

Sağlayıcıların aşağıdaki özel durumları oluşturması gerekir.

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

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

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

Ayrıca bkz.