ToolTip Denetim Türü iç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, ToolTip 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.
Araç ipucu denetimleri, metin içeren açılır pencerelerdir.
Aşağıdaki bölümlerde ToolTip 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 araç ipucu denetimleri için geçerlidir.
Gerekli UI Otomasyonu Ağaç Yapısı
Aşağıdaki tabloda, araç ipucu 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ğacına Genel Bakış.
| Denetim Görünümü | İçerik Görünümü |
|---|---|
| ToolTip - Metin (0 veya daha fazla) - Görüntü (0 veya daha fazla) |
ToolTip |
Araç ipucu denetimleri yalnızca klavye odağı alabilmeleri durumunda UI Otomasyonu ağacının İçerik Görünümünde görünür. Aksi takdirde, araç ipucunun tüm bilgileri, araç ipucunun HelpTextProperty başvurduğunu UI Otomasyonu öğesinden edinilebilir.
Araç ipuçları, bilgilerinin başvurduğunu denetimin altında görünmelidir. İstemciler, araç ipuçlarında ToolTipOpenedEvent yer alan bilgileri tutarlı bir şekilde edindiklerinden emin olmak için öğesini dinlemelidir.
Gerekli UI Otomasyonu Özellikleri
Aşağıdaki tabloda, değeri veya tanımı özellikle araç ipucu denetimleriyle 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. | Tıklanabilir nokta, araç ipucunun denetimi kapatacak bölümü olmalıdır. Bazı araç ipuçlarının bu özelliği yoktur ve tıklanabilir bir noktası yoktur. |
| IsKeyboardFocusableProperty | Notlara bakın. | Denetim klavye odağını alabiliyorsa bu özelliği desteklemesi gerekir. |
| NameProperty | Notlara bakın. | Araç ipucu denetiminin adı, araç ipucu içinde görüntülenen metindir. |
| LabeledByProperty | Null |
Araç ipucu denetimleri her zaman içerikleri tarafından kendi kendine etiketlenir. |
| ControlTypeProperty | ToolTip | Bu değer tüm ui çerçeveleri için aynıdır. |
| LocalizedControlTypeProperty | "araç ipucu" | ToolTip denetim türüne karşılık gelen yerelleştirilmiş dize. |
| IsContentElementProperty | -Sına bağ -lıdır | Araç ipucu denetimi klavye odağını alabiliyorsa, ağacın İçerik Görünümü'nde olmalıdır. Yalnızca metinse, onu oluşturan denetimden HelpTextProperty olarak kullanılabilir. |
| IsControlElementProperty | True | Araç ipucu denetimi her zaman bir denetim olmalıdır. |
Gerekli UI Otomasyonu Denetim Desenleri
Aşağıdaki tabloda, araç ipucu 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 |
|---|---|---|
| IWindowProvider | -Sına bağ -lıdır | Bir kullanıcı arabirimi öğesine tıklanarak kapatılabilen araç ipuçları, otomatik olarak kapatılabilmesi için WindowPattern'ı desteklemelidir. |
| ITextProvider | -Sına bağ -lıdır | Daha iyi erişilebilirlik için, bir araç ipucu denetimi Gerekli olmasa da Metin denetimi desenini destekleyebilir. Metin denetim düzeni, zengin stil ve özniteliklere (örneğin, renk, kalın ve italik) sahip olduğunda kullanışlıdır. |
Gerekli UI Otomasyonu Olayları
Araç ipucu denetimleri, ekranda göründüklerinde öğesini yükseltmelidir ToolTipOpenedEvent . Olay, araç ipucunun UI Otomasyonu öğesine bir başvuru içerir.
Aşağıdaki tabloda, tüm araç ipucu 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 |
|---|---|---|
| TextSelectionChangedEvent | -Sına bağ -lıdır | Hiçbiri |
| TextChangedEvent | -Sına bağ -lıdır | Hiçbiri |
| WindowClosedEvent | -Sına bağ -lıdır | Hiçbiri |
| WindowOpenedEvent | -Sına bağ -lıdır | Hiçbiri |
| ToolTipOpenedEvent | Zorunlu | Hiçbiri |
| ToolTipClosedEvent | 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 |
| WindowVisualStateProperty property-changed olayı. | -Sına bağ -lıdır | Hiçbiri |
| AutomationFocusChangedEvent | Zorunlu | Hiçbiri |
| StructureChangedEvent | Zorunlu | Hiçbiri |