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).
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. |