Share via

İstemciler İçin UI Otomasyon Denetim Düzenleri

  • Makale

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 genel bakış, UI Otomasyonu istemcileri için denetim desenlerini tanıtır. Bir UI Otomasyonu istemcisinin kullanıcı arabirimi (UI) hakkındaki bilgilere erişmek için denetim desenlerini nasıl kullanabileceğine ilişkin bilgiler içerir.

Denetim desenleri, denetimin işlevselliğini denetim türünden veya denetimin görünümünden bağımsız olarak kategorilere ayırmanın ve kullanıma sunmanın bir yolunu sağlar. UI Otomasyonu istemcileri hangi denetim desenlerinin desteklendiğine karar vermek ve denetimin davranışından emin olmak için bir AutomationElement dosyasını inceleyebilir.

Denetim desenlerinin tam listesi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.

Denetim Desenlerini Alma

İstemciler veya AutomationElement.GetCurrentPatternçağırarak AutomationElement.GetCachedPattern bir AutomationElement denetim deseni alır.

İstemciler, üzerinde bir desenin veya desen grubunun desteklenip desteklenmediğini AutomationElementbelirlemek için yöntemini veya tek bir IsPatternAvailable özelliği (örneğin, IsTextPatternAvailableProperty) kullanabilirGetSupportedPatterns. Ancak, desteklenen özellikleri denetlemek ve daha az çapraz işlem çağrısıyla sonuçlandığından denetim desenini almaktan daha verimlidir null .

Aşağıdaki örnekte, bir TextPattern 'den AutomationElementbir denetim deseninin nasıl alınıyor olduğu gösterilmektedir.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Denetim Desenlerinde Özellikleri Alma

İstemciler, denetim desenlerindeki özellik değerlerini veya AutomationElement.GetCurrentPropertyValue çağırarak AutomationElement.GetCachedPropertyValue ve döndürülen nesneyi uygun bir türe dönüştürerek alabilir. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.

Yöntemlere GetPropertyValue ek olarak, özellik değerleri bir desendeki UI Otomasyonu özelliklerine erişmek için ortak dil çalışma zamanı (CLR) erişimcileri aracılığıyla alınabilir.

Değişken Desenli Denetimler

Bazı denetim türleri, durumlarına veya denetimin kullanılma şekline bağlı olarak farklı desenleri destekler. Değişken desenleri olabilecek denetimlere örnek olarak liste görünümleri (küçük resimler, kutucuklar, simgeler, liste, ayrıntılar), Microsoft Excel Grafikleri (Pasta, Çizgi, Çubuk, Formül içeren Hücre Değeri), Microsoft Word'ün belge alanı (Normal, Web Düzeni, Ana Hat, Yazdırma Düzeni, Baskı Önizleme) ve Microsoft Windows Medya Oynatıcı kaplamaları verilebilir.

Özel denetim türlerini uygulayan denetimler, işlevlerini temsil etmek için gereken herhangi bir denetim deseni kümesine sahip olabilir.

Ayrıca bkz.