Aracılığıyla paylaş

UI Otomasyonu Değer Denetimi Desenini Uygulama

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.

Bu konu başlığında, olaylar ve özelliklerle ilgili bilgiler de dahil olmak üzere uygulamasına IValueProvideryönelik yönergeler ve kurallar tanıtılmaktadır. Ek başvuruların bağlantıları, konunun sonunda listelenir.

Denetim ValuePattern düzeni, bir aralığı kapsamayan ve dize olarak temsil edilebilen bir iç değere sahip denetimleri desteklemek için kullanılır. Bu dize, denetime ve ayarlarına bağlı olarak düzenlenebilir. Bu deseni uygulayan denetim örnekleri için bkz. UI Otomasyonu İstemcileri için Denetim Deseni Eşlemesi.

Uygulama Yönergeleri ve Kuralları

Değer denetimi desenini uygularken aşağıdaki yönergelere ve kurallara dikkat edin:

  • Contoller ListItem ve TreeItem gibi denetimler, geçerli düzenleme modundan bağımsız olarak öğelerden herhangi birinin değeri düzenlenebilir olduğunda ValuePattern desteklemelidir. Ana denetim, alt öğeler düzenlenebilir ise ValuePattern da desteklemelidir.

Düzenlenebilir liste öğesi. Düzenlenebilir Liste Öğesi Örneği

  • Tek satırlı düzenleme denetimleri, IValueProvider uygulayarak içeriklerine program aracılığıyla erişimi sağlayabilir. Ancak, çok satırlı düzenleme denetimleri IValueProvider'yi uygulamaz; bunun yerine içeriklerine erişimi ITextProvider aracılığıyla sağlarlar.

  • Çok satırlı bir düzenleme denetleyicisinden metin içeriğini almak için denetleyicinin ITextProvider uygular olması gerekir. Ancak, ITextProvider denetimin değerini ayarlamayı desteklemez.

  • IValueProvider biçimlendirme bilgilerinin veya alt dize değerlerinin alınmasını desteklemez. ITextProvider öğesini bu senaryolarda uygulayın.

  • IValueProvider Bir renk değeri (örneğin, "sarı") ve eşdeğer bir iç RGB yapısı arasında dize eşlemeyi destekleyen Microsoft Word'den Renk Seçici seçim denetimi (aşağıda gösterilmiştir) gibi denetimler tarafından uygulanmalıdır.

Sarı vurgulanmış renk seçici. Renk Renk Örneği Dizesi Eşleme Örneği

IValueProvider için Gerekli Üyeler

uygulamak IValueProvideriçin aşağıdaki özellikler ve yöntemler gereklidir.

Gerekli üyeler Üye türü Notlar
IsReadOnlyProperty Mülkiyet Hiç kimse
ValueProperty Mülkiyet Hiç kimse
SetValue Yöntem Hiç kimse

Özel durumlar

Sağlayıcılar, aşağıdaki özel durumları fırlatmalıdır.

Özel durum türü Koşul
InvalidOperationException SetValue

- Yerel ayara özgü bilgiler, yanlış biçimlendirilmiş bir tarih gibi, yanlış formatta bir kontrol öğesine aktarılırsa.
ArgumentException SetValue

- Yeni bir değer bir dizeden denetimin tanıdığı biçime dönüştürülemiyorsa.
ElementNotEnabledException SetValue

- Etkin olmayan bir denetimi işleme girişiminde bulunulduğunda.

Ayrıca bakınız

  • Last updated on