UI Otomasyon Özelliklerine Genel Bakış
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.
UI Otomasyonu sağlayıcıları Microsoft UI Otomasyonu öğelerindeki özellikleri kullanıma sunar. Bu özellikler, UI Otomasyonu istemci uygulamalarının kullanıcı arabiriminin (UI) parçaları, özellikle de hem statik hem de dinamik veriler dahil olmak üzere denetimler hakkındaki bilgileri keşfetmesini sağlar.
Bu bölümde Microsoft UI Otomasyonu özelliklerine genel bir genel bakış sunun. Aşağıdaki konularda daha ayrıntılı bilgiler verilmiştir:
Özellik Tanımlayıcıları
Her özellik bir sayı ve bir adla tanımlanır. Özelliklerin adları yalnızca hata ayıklama ve tanılama için kullanılır. Sağlayıcılar, gelen özellik isteklerini tanımlamak için sayısal kimlikleri kullanır. Ancak istemci uygulamaları, almak istedikleri özellikleri tanımlamak için yalnızca AutomationPropertysayı ve adı kapsülleyen kullanın.
AutomationProperty belirli özellikleri temsil eden nesneler çeşitli sınıflarda alan olarak kullanılabilir. Güvenlik nedeniyle, UI Otomasyonu sağlayıcıları bu nesneleri Uiautomationtypes.dll'de bulunan ayrı bir sınıf kümesinden alır.
Aşağıdaki tablo, kimlikleri içeren sınıflara göre özellikleri kategorilere AutomationPropertyayırır.
Özellik türleri | İstemciler kimlikleri şu kaynaktan alır: | Sağlayıcılar kimlikleri şu kaynaktan alır: |
---|---|---|
Tüm öğeler için ortak özellikler (aşağıdaki tablolara bakın) | AutomationElement | AutomationElementIdentifiers |
Yerleştirme penceresinin konumu | DockPattern | DockPatternIdentifiers |
Genişletilebilen ve daraltabilen bir öğenin durumu | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
Kılavuzdaki bir öğenin özellikleri | GridItemPattern | GridItemPatternIdentifiers |
Kılavuzun özellikleri | GridPattern | GridPatternIdentifiers |
Birden çok görünümü olan bir öğenin geçerli ve desteklenen görünümü | MultipleViewPattern | MultipleViewPatternIdentifiers |
Kaydırıcı gibi bir değer aralığı üzerinde hareket eden öğenin özellikleri | RangeValuePattern | RangeValuePatternIdentifiers |
Kaydırma penceresinin özellikleri | ScrollPattern | ScrollPatternIdentifiers |
Listede olduğu gibi seçilebilen öğenin durumu ve kapsayıcısı | SelectionItemPattern | SelectionItemPatternIdentifiers |
Seçim öğelerini içeren denetimin özellikleri | SelectionPattern | SelectionPatternIdentifiers |
Tablodaki bir öğenin sütun ve satır üst bilgileri | TableItemPattern | TableItemPatternIdentifiers |
Tablonun sütun ve satır üst bilgileri ve yönlendirmesi | TablePattern | TablePatternIdentifiers |
Geçiş denetiminin durumu | TogglePattern | TogglePatternIdentifiers |
Taşınabilen, döndürülebilen veya yeniden boyutlandırılabilir bir öğenin özellikleri | TransformPattern | TransformPatternIdentifiers |
Değeri olan bir öğenin değer ve okuma/yazma özellikleri | ValuePattern | ValuePatternIdentifiers |
Pencerenin özellikleri ve durumu | WindowPattern | WindowPatternIdentifiers |
Kategoriye Göre Özellikler
Aşağıdaki tablolar, ve AutomationElementIdentifiersiçinde kimlikleri bulunan AutomationElement özellikleri kategorilere ayırır. Bu özellikler tüm denetimler için ortaktır. Bunların birkaçı dışında tümü, sağlayıcı uygulamasının ömrü boyunca statik olabilir; çoğu dinamik özellik denetim desenleriyle ilişkilendirilir.
Özellik Erişimi sütunu, ve'ye GetCurrentPropertyValueGetCachedPropertyValueek olarak her özellik için diğer erişimcileri listeler. İstemci uygulamasında özellikleri alma hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.
Not
Her özellik hakkında belirli bilgiler için Özellik Erişimi sütunundaki bağlantıyı izleyin.
Özellikleri Görüntüle
Özellik tanımlayıcısı | Özellik erişimi |
---|---|
BoundingRectangleProperty | BoundingRectangle |
CultureProperty | yok |
HelpTextProperty | HelpText |
IsOffscreenProperty | IsOffscreen |
OrientationProperty | Orientation |
Öğe Türü
Özellik tanımlayıcısı | Özellik erişimi |
---|---|
ControlTypeProperty | ControlType |
IsContentElementProperty | IsContentElement |
IsControlElementProperty | IsControlElement |
ItemTypeProperty | ItemType |
LocalizedControlTypeProperty | LocalizedControlType |
Kimlik
Etkileşim
Desen desteği
Çeşitli
Özellik tanımlayıcısı | Özellik erişimi |
---|---|
IsRequiredForFormProperty | IsRequiredForForm |
IsPasswordProperty | IsPassword |
ItemStatusProperty | ItemStatus |
Localization (Yerelleştirme)
UI Otomasyonu sağlayıcıları işletim sisteminin dilinde aşağıdaki özellikleri sunmalıdır:
Özellikler ve Olaylar
UI Otomasyonu özelliklerine yakından bağlı olan, özellik tarafından değiştirilen olaylar kavramıdır. Dinamik özellikler için istemci uygulamasının, bir özellik değerinin değiştirildiğini bilmesi ve böylece bilgi önbelleğini güncelleştirebilmesi veya yeni bilgilere başka bir şekilde tepki vermesi gerekir.
Sağlayıcılar, kullanıcı arabirimindeki bir şey değiştiğinde olayları tetikler. Örneğin, onay kutusu seçili veya temizlenmişse, sağlayıcının Geçiş düzeni uygulaması tarafından özellik değişikliği olayı oluşturulur. Sağlayıcılar, istemcilerin olayları dinleyip dinlemediğine veya belirli olayları dinlediğine bağlı olarak olayları seçmeli olarak oluşturabilir.
Tüm özellik değişiklikleri olayları tetiklemiyor; bu tamamen öğe için UI Otomasyonu sağlayıcısının uygulanmasına kadardır. Örneğin, liste kutuları için standart ara sunucu sağlayıcıları, değişiklikler olduğunda SelectionProperty bir olay tetiklemiyor. Bu durumda, uygulamanın bir ElementSelectedEventdinlemesi gerekir.
İstemciler olayları abone olarak dinler. Olaylara abone olmak, olayları işleyebilen temsilci yöntemleri oluşturmak ve ardından yöntemleri bu yöntemlerde ele alınacak belirli olaylarla birlikte UI Otomasyonu geçirmek anlamına gelir. Özellikle özellik tarafından değiştirilen olaylar için istemcilerin uygulaması AutomationPropertyChangedEventHandlergerekir.