Düzenleme Denetim Türü İçin UI Otomasyon Desteği
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, Düzenleme denetim türü için UI Otomasyonu desteği hakkında bilgi sağlanır. UI Otomasyonu denetim türü, bir denetimin özelliğini kullanabilmesi için karşılaması gereken bir koşul kümesidirControlTypeProperty. Koşullar UI Otomasyonu ağaç yapısı, UI Otomasyonu özellik değerleri ve denetim desenleri için belirli yönergeleri içerir.
Düzenleme denetimleri, kullanıcının zengin biçimlendirme desteği olmadan basit bir metin satırını görüntülemesine ve düzenlemesine olanak tanır.
Aşağıdaki bölümler Düzenleme denetim türü için gerekli UI Otomasyonu ağaç yapısını, özelliklerini, denetim desenlerini ve olaylarını tanımlar. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm düzenleme denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, denetimleri düzenlemeyle ilgili UI Otomasyonu ağacının denetim görünümü ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceği açıklanır. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyonu Ağaca Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| Düzenle | Düzenle |
Düzenle denetim türünü uygulayan denetimlerin tek satırlı bir denetim olduğundan UI Otomasyonu ağacının denetim görünümünde her zaman sıfır kaydırma çubuğu olur. Metnin tek satırı bazı düzen senaryolarında kaydırılabilir. Düzenle denetim türü, küçük miktarlarda düzenlenebilir veya seçilebilir metin tutmak için en uygun yöntemdir.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı düzenleme denetimleriyle özellikle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. İstemciler için Özellikler UI Otomasyonu.
| UI Otomasyonu Özelliği | Değer | Notlar |
|---|---|---|
| AutomationIdProperty | Notlara bakın. | Bu özelliğin değerinin bir uygulamadaki tüm denetimlerde benzersiz olması gerekir. |
| BoundingRectangleProperty | Notlara bakın. | Denetimin tamamını içeren en dıştaki dikdörtgen. |
| ClickablePointProperty | Notlara bakın. | Düzenleme denetiminin, kullanıcı fareye tıkladığında denetimin düzenleme bölümüne giriş odağı veren tıklanabilir bir noktası olmalıdır. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| NameProperty | Notlara bakın. | Düzenleme denetiminin adı genellikle statik bir metin etiketinden oluşturulur. Statik metin etiketi yoksa, için Name bir özellik değeri uygulama geliştiricisi tarafından atanmalıdır. Name özelliği hiçbir zaman düzenleme denetiminin metin içeriğini içermemelidir. |
| LabeledByProperty | Notlara bakın. | Denetimle ilişkilendirilmiş statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuruyu kullanıma sunması gerekir. Metin denetimi başka bir denetimin alt bileşeniyse, bir özellik kümesine sahip LabeledBy olmaz. |
| ControlTypeProperty | Düzenle | Bu değer tüm ui çerçeveleri için aynıdır. |
| LocalizedControlTypeProperty | "düzenle" | Düzenleme denetim türüne karşılık gelen yerelleştirilmiş dize. |
| IsContentElementProperty | True | Düzenleme denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | Düzenleme denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| IsPasswordProperty | Notlara bakın. | Parola içeren düzenleme denetimlerinde true olarak ayarlanmalıdır. Düzenleme denetimi Parola içeriği içeriyorsa, bu özellik kullanıcı yazarken tuş vuruşlarının okunması gerekip gerekmediğini belirlemek için ekran okuyucu tarafından kullanılabilir. |
Gerekli UI Otomasyonu Denetim Desenleri ve Özellikleri
Aşağıdaki tabloda, tüm düzenleme denetimleri tarafından desteklenmesi için gereken denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.
| Denetim Deseni/Denetim Deseni Özelliği | Destek/Değer | Notlar |
|---|---|---|
| ITextProvider | -Sına bağ -lıdır | Ayrıntılı metin bilgilerinin istemciler için her zaman kullanılabilir olması gerektiğinden, düzenleme denetimleri Metin denetimi düzenini desteklemelidir. |
| IValueProvider | -Sına bağ -lıdır | Dize alan tüm düzenleme denetimleri Value desenini kullanıma sunmalıdır. |
| IsReadOnly | Notlara bakın. | Denetimin program aracılığıyla ayarlanmış bir değere sahip olup olmadığını veya kullanıcı tarafından düzenlenebilir olup olmadığını belirtmek için bu özellik ayarlanmalıdır. |
| Value | Notlara bakın. | Bu özellik düzenleme denetiminin metin içeriğini döndürür. IsPasswordProperty olarak ayarlanırsatrue, bu özellik istendiğinde bir InvalidOperationException oluşturmalıdır. |
| IRangeValueProvider | -Sına bağ -lıdır | Sayısal aralık alan tüm düzenleme denetimleri Aralık Değeri denetim düzenini kullanıma sunmalıdır. |
| Minimum | Notlara bakın. | Bu özellik, düzenleme denetiminin içeriğinin ayarlanabileceği en küçük değer olmalıdır. |
| Maximum | Notlara bakın. | Bu özellik, düzenleme denetiminin içeriğinin ayarlanabileceği en büyük değer olmalıdır. |
| SmallChange | Notlara bakın. | Bu özellik, değerin ayarlanabileceği ondalık basamak sayısını göstermelidir. Düzenleme yalnızca tamsayıları alıyorsa, SmallChangeProperty değeri 1 olmalıdır. Düzenleme 1,0 ile 2,0 arasında bir aralık alıyorsa, SmallChangeProperty 0,1 olmalıdır. Düzenleme denetimi 1,00 ile 2,00 SmallChangeProperty arasında bir aralık alıyorsa, 0,001 olmalıdır. |
| LargeChange | Null |
Bu özelliğin bir düzenleme denetiminde kullanıma açık olması gerekmez. |
| Value | Notlara bakın. | Bu özellik düzenleme denetiminin sayısal içeriğini gösterir. ve Maximum özelliklerinde Minimum belirtilen aralıklar içinde bir UI Otomasyonu istemcisi tarafından daha hassas bir değer ayarlandığında, Value özelliği otomatik olarak kabul edilen en yakın değere yuvarlanacaktır. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm düzenleme denetimleri tarafından desteklenmesi gereken UI Otomasyonu olayları listelenmektedir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylara Genel Bakış.
| UI Otomasyonu Olayı | Destek | Notlar |
|---|---|---|
| InvalidatedEvent | Zorunlu | Hiçbiri |
| TextSelectionChangedEvent | Zorunlu | Hiçbiri |
| TextChangedEvent | Zorunlu | Hiçbiri |
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| NameProperty property-changed olayı. | Zorunlu | Hiçbiri |
| ValueProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| HorizontallyScrollableProperty property-changed olayı. | Asla | Hiçbiri |
| HorizontalScrollPercentProperty property-changed olayı. | Asla | Hiçbiri |
| HorizontalViewSizeProperty property-changed olayı. | Asla | Hiçbiri |
| VerticalScrollPercentProperty property-changed olayı. | Asla | Hiçbiri |
| VerticallyScrollableProperty property-changed olayı. | Asla | Hiçbiri |
| VerticalViewSizeProperty property-changed olayı. | Asla | Hiçbiri |
| ValueProperty property-changed olayı. | -Sına bağ -lıdır | Denetim, Değer denetimi deseni aralığını destekliyorsa, bu olayı desteklemesi gerekir. |
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |