Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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.
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üm, Microsoft UI Otomasyonu özelliklerine genel bir genel bakış sağlar. 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 mülk isteklerini tanımlamak için sayısal kimlikleri kullanır. İstemci uygulamaları, almak istedikleri özellikleri tanımlamak için, yalnızca sayıyı ve adı kapsülleyen AutomationProperty'ü kullanır.
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.dlliçinde yer alan ayrı bir sınıf kümesinden alır.
Aşağıdaki tablo, AutomationPropertykimlikleri içeren sınıflara göre özellikleri kategorize eder.
| Mülk 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 |
| Izgaradaki bir öğenin özellikleri | GridItemPattern | GridItemPatternIdentifiers |
| Izgaranın ö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, AutomationElement ve AutomationElementIdentifiers içinde kimlikleri bulunan ö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, GetCurrentPropertyValue ve GetCachedPropertyValue'ye ek 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 UI Otomasyonu Özellikleri.
Uyarı
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 |
Yerelleştirme
UI Otomasyonu sağlayıcıları işletim sisteminin dilinde aşağıdaki özellikleri sunmalıdır:
Özellikler ve Olaylar
UI Otomasyonu'ndaki özelliklerle yakından ilişkili olan, özellik değişikliği 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çildiğinde veya temizlendiğinde, sağlayıcının Geçiş örüntüsü uygulaması tarafından bir ö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 uygulamasına bağlıdır. Örneğin, liste kutuları için standart vekil sunucu sağlayıcıları, SelectionProperty değiştiğinde 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 UI Otomasyonu'na ve bu yöntemlerde ele alınacak belirli olaylara geçirmek anlamına gelir. Özellikle özellik tarafından değiştirilen olaylar için istemcilerin AutomationPropertyChangedEventHandler uygulaması gerekir.