Denetim Türünü Düzenle
Bu konu başlığında, Düzenle denetim türü için Microsoft UI Automation desteği hakkında bilgi sağlanır.
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ümlerde düzenleme denetimi türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, UI çerçevesinin/platformunun denetim türleri ve denetim desenleri için UI Otomasyonu desteğini tümleştirdiği tüm düzenleme denetimleri için geçerlidir.
Bu konu aşağıdaki bölümleri içerir.
- Tipik Ağaç Yapısı
- İlgili Özellikler
- Gerekli Denetim Desenlerini
- Gerekli Olayları
- Açıklamalar
- İlgili konular
Tipik Ağaç Yapısı
Aşağıdaki tabloda, denetimleri düzenlemeyle ilgili ui Otomasyonu ağacının tipik bir denetimi ve içerik görünümü gösterilir ve her görünümde nelerin içerilebileceğini açıklar. UI Otomasyonu ağacı hakkında daha fazla bilgi için bkz. UI Otomasyon Ağacına Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
|
|
Düzenle denetim türünü uygulayan denetimler, 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ğuna sahip olur. Metnin tek satırı bazı düzen senaryolarında kaydırılabilir. Düzenle denetim türü yalnızca küçük miktarda metin içindir.
İlgili Özellikler
Aşağıdaki tabloda, değeri veya tanımı özellikle düzenleme denetimleriyle ilgili olan UI Otomasyonu özellikleri listeleniyor. UI Otomasyonu özellikleri hakkında daha fazla bilgi için bkz. UI Automation Öğelerinden Özellikleri Alma.
| UI Otomasyonu Özelliği | Değer | Notlar |
|---|---|---|
| UIA_AutomationIdPropertyId | Notlara bakın. | Bu özelliğin değeri, UI Otomasyonu ağacının ham görünümündeki tüm eş öğeler arasında benzersiz olmalıdır. |
| UIA_BoundingRectanglePropertyId | Notlara bakın. | Denetimin tamamını içeren en dıştaki dikdörtgen. |
| UIA_ClickablePointPropertyId | 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. |
| UIA_ControlTypePropertyId | Düzenle | |
| UIA_IsContentElementPropertyId | true | Düzenleme denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| UIA_IsControlElementPropertyId | true | Düzenleme denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| UIA_IsKeyboardFocusablePropertyId | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| UIA_IsPasswordPropertyId | 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. |
| UIA_LabeledByPropertyId | Notlara bakın. | Denetimle ilişkilendirilmiş statik bir metin etiketi varsa, bu özelliğin bu denetime bir başvuru kullanıma sunması gerekir. Metin denetimi başka bir denetimin alt bileşeniyse, LabeledBy özelliği ayarlanmış sahip olmaz. |
| UIA_LocalizedControlTypePropertyId | Notlara bakın. | Düzenle denetim türüne karşılık gelen yerelleştirilmiş dize. Varsayılan değer, en-US veya İngilizce (ABD) için "düzenle"dir. |
| UIA_NamePropertyId | Notlara bakın. | Düzenleme denetiminin adı genellikle statik bir metin etiketinden oluşturulur. Statik metin etiketi yoksa, Name için bir özellik değeri uygulama geliştiricisi tarafından atanmalıdır. Adı özelliği hiçbir zaman düzenleme denetiminin metin içeriğini içermemelidir. |
Gerekli Denetim Desenleri
Aşağıdaki tabloda, düzenleme denetimleri tarafından desteklenmesi için gereken UI Otomasyonu denetim desenleri listelenmektedir. Denetim desenleri hakkında daha fazla bilgi için bkz. UI Otomasyonu Denetim Desenlerine Genel Bakış.
| Denetim Deseni/Desen Özelliği | Destek/Değer | Notlar |
|---|---|---|
| IRangeValueProvider | -Sına bağ -lıdır | Sayısal aralık alan tüm düzenleme denetimleri, RangeValue denetim desenini göstermelidir. |
| Minimum | Notlara bakın. | Bu özellik, düzenleme denetiminin içeriğinin ayarlanabildiği en küçük değer olmalıdır. |
| En Fazla | Notlara bakın. | Bu özellik, düzenleme denetiminin içeriğinin ayarlanabildiğ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 denetimi yalnızca tamsayılar alıyorsa, SmallChange özellik değeri 1 olmalıdır. Düzenleme denetimi 1,0 ile 2,0 arasında bir aralık alıyorsa, SmallChange özellik değeri 0,1 olmalıdır. Düzenleme denetimi 1,00 ile 2,00 arasında bir aralık alıyorsa SmallChange özellik değeri 0,001 olmalıdır. |
| LargeChange | NULL | Bu özelliğin bir düzenleme denetiminde kullanıma açık olması gerekmez. |
| Değer | Notlara bakın. | Bu özellik, düzenleme denetiminin sayısal içeriğini gösterir. En Düşük ve En Fazla özelliklerinde belirtilen aralıklar içinde ui Otomasyonu istemcisi tarafından daha hassas bir değer ayarlandığında, Değeri özelliği otomatik olarak kabul edilen en yakın değere yuvarlanr. |
| ITextProvider | Gerekli | Tüm düzenleme denetimleri Metin denetim desenini desteklemelidir çünkü yardımcı teknoloji istemcileri için ayrıntılı bilgiler her zaman kullanılabilir olmalıdır. |
| IValueProvider | -Sına bağ -lıdır | Dize alan tüm düzenleme denetimleri, Değer denetim 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üzenlenebileceğini belirtmek için bu özellik ayarlanmalıdır. |
| Değer | Notlara bakın. | Bu özellik, düzenleme denetiminin metin içeriğini içerir. UIA_IsPasswordPropertyId özelliği true olarak ayarlanırsa, Value özelliğini sorgulamak bir hata döndürmelidir. |
Gerekli Olaylar
Aşağıdaki tabloda, denetimleri düzenlemek için gereken UI Otomasyonu olayları listelenir. Olaylar hakkında daha fazla bilgi için bkz. UI Otomasyonu Olaylarına Genel Bakış.
| UI Otomasyonu Olayı | Notlar |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| özelliği değiştirilmiş olayı UIA_BoundingRectanglePropertyId. | |
| özelliği değiştirilmiş olayı UIA_IsEnabledPropertyId. | Denetim IsEnabledözelliğini destekliyorsa bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_IsOffscreenPropertyId. | Denetim IsOffscreen özelliğini destekliyorsa, bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_NamePropertyId. | |
| özelliği değiştirilmiş olayı UIA_RangeValueValuePropertyId. | Denetim, RangeValue denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_ScrollHorizontallyScrollablePropertyId. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| özelliği değiştirilmiş olayı UIA_ScrollHorizontalScrollPercentPropertyId. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| özelliği değiştirilmiş olayı UIA_ScrollHorizontalViewSizePropertyId. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| özelliği değiştirilmiş olayı UIA_ScrollVerticallyScrollablePropertyId. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| Özellik değiştirme olayını UIA_ScrollVerticalScrollPercentPropertyId. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| UIA_ScrollVerticalViewSizePropertyId özelliği değiştirilmiş olay. | Düzenleme denetimi hiçbir zaman Kaydırma denetim desenini desteklemez. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Denetim Metin denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| UIA_Text_TextSelectionChangedEventId | Denetim Metin denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
| özelliği değiştirilmiş olayı UIA_ValueValuePropertyId. | Denetim Değer denetim desenini destekliyorsa, bu olayı desteklemesi gerekir. |
Açıklamalar
Düzenleme denetimi, metnin seçilmesini veya düzenlenmesini desteklemeyen salt okunur bir metin alanı olarak kullanılabilir. Böyle bir düzenleme denetimi, belirli bir ada ve değere sahip bir alan nesnesi olarak davranır.
Düzenleme denetimi yer tutucu metin içeriyorsa (örneğin, ipucu başlığı), metin kullanıcı tarafından düzenlenip yer tutucu metin olarak yeniden kullanılamadığı sürece, metin HelpText özelliği olarak kullanılmalıdır. Örneğin, Windows Internet Explorer adres çubuğu yeni bir sekme açıldığında "about:Tabs" metnini içerir. Bu, kullanıcı tarafından kullanılabilecek veya düzenlenebilen programlı bir adres olduğundan HelpText değildir.
İlgili konular