Aracılığıyla paylaş

UI Otomasyonu Değer Denetim Düzenini Uygulama

  • 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 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:

  • ve gibi ListItemTreeItem denetimler, denetimin geçerli düzenleme modundan bağımsız olarak öğelerin herhangi birinin değerinin düzenlenebilir olup olmadığını desteklemelidir ValuePattern . Üst denetim, alt öğelerin düzenlenebilir olup olmadığını da desteklemelidir ValuePattern .

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

  • Tek satırlı düzenleme denetimleri, uygulayarak IValueProvideriçeriklerine program aracılığıyla erişimi destekler. Ancak, çok satırlı düzenleme denetimleri uygulamaz IValueProvider; bunun yerine uygulayarak ITextProvideriçeriklerine erişim sağlarlar.

  • Çok satırlı düzenleme denetiminin metin içeriğini almak için denetimin uygulaması ITextProvidergerekir. Ancak, ITextProvider denetimin değerini ayarlamayı desteklemez.

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

  • IValueProviderBir 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 Özellik Hiçbiri
ValueProperty Özellik Hiçbiri
SetValue Metot Hiçbiri

Özel durumlar

Sağlayıcıların aşağıdaki özel durumları oluşturması gerekir.

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

- Yerel ayara özgü bilgiler yanlış biçimlendirilmiş bir tarih gibi yanlış biçimde bir denetime geçirilirse.
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 bkz.