Belge 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, Belge denetim türü için UI Otomasyonu desteği hakkında bilgi sağlar. 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.
Belge denetimleri, kullanıcının birden çok metin sayfasını görüntülemesine ve işlemesine olanak tanır. Yalnızca biçimlendirilmemiş basit bir metin satırını destekleyen düzenleme denetimlerinden farklı olarak, belge denetimleri zengin stile sahip ve biçimlendirilmiş metinleri barındırabilir.
Aşağıdaki bölümlerde Belge denetim türü için gerekli UI Otomasyonu ağaç yapısı, özellikleri, denetim desenleri ve olayları tanımlanmıştır. UI Otomasyonu gereksinimleri, Windows Presentation Foundation (WPF), Win32 veya Windows Forms olsun tüm belge denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, belge denetimleriyle 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ü |
|---|---|
| Belge -Değişir |
Belge -Değişir |
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı belge 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. | Belge, belge kapsayıcısında kendi öğelerinden birinin belgesinde odağın olmasına neden olacak tıklanabilir bir noktaya sahiptir. |
| ControlTypeProperty | Belge | Bu değer tüm ui çerçeveleri için aynıdır. |
| IsContentElementProperty | True | Belge denetimi her zaman UI Otomasyonu ağacının içerik görünümüne eklenir. |
| IsControlElementProperty | True | Belge denetimi her zaman UI Otomasyonu ağacının denetim görünümüne eklenir. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| LabeledByProperty | Notlara bakın. | Bu özelliğin değeri belge denetiminin etiketi olmalıdır. Genellikle, belgenin başlığı kullanılır. |
| LocalizedControlTypeProperty | "belge" | Belge denetim türüne karşılık gelen yerelleştirilmiş dize. |
| NameProperty | Notlara bakın. | Belge denetimi genellikle adlarını yüklendiği dosya adından alır. Bu genellikle içeren bir pencere veya çerçeve başlığında görüntülenir. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, belge 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 | Destek | Notlar |
|---|---|---|
| IScrollProvider | -Sına bağ -lıdır | Belge denetimi, görünüm penceresine ait olandan daha büyük bir kapsama yayılabilir. İçerik kaydırılabilirse denetimin Kaydırma denetimi düzenini desteklemesi gerekir. |
| ITextProvider | Zorunlu | Belge denetimi, görünüm penceresine ait olandan daha büyük bir kapsama yayılabilir. İçerik kaydırılabilirse denetimin Kaydırma denetimi düzenini desteklemesi gerekir. |
| IValueProvider | Asla | Denetimin içeriği genellikle birden fazla sayfaya yayılacağından, belge denetimi bu denetim düzenini desteklemez. UI Otomasyonu istemcileri bir belge hakkında metin bilgilerini almak için kullanmalıdırTextPattern. |
Gerekli UI Otomasyonu Olayları
Aşağıdaki tabloda, tüm belge 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 |
|---|---|---|
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| BoundingRectangleProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsEnabledProperty property-changed olayı. | Zorunlu | Hiçbiri |
| IsOffscreenProperty property-changed olayı. | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |
| HorizontallyScrollableProperty property-changed olayı. | Zorunlu | Hiçbiri |
| HorizontalScrollPercentProperty property-changed olayı. | Zorunlu | Hiçbiri |
| HorizontalViewSizeProperty property-changed olayı. | Zorunlu | Hiçbiri |
| VerticalScrollPercentProperty property-changed olayı. | Zorunlu | Hiçbiri |
| VerticallyScrollableProperty property-changed olayı. | Zorunlu | Hiçbiri |
| VerticalViewSizeProperty property-changed olayı. | Zorunlu | Hiçbiri |
| InvalidatedEvent | -Sına bağ -lıdır | Denetim Seçim denetim desenini destekliyorsa bu olayı desteklemesi gerekir. |
| TextSelectionChangedEvent | Zorunlu | Hiçbiri |
| TextChangedEvent | Zorunlu | Hiçbiri |
| ValueProperty property-changed olayı. | Asla | Hiçbiri |