Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Megjegyzés:
Ez a dokumentáció azoknak a .NET-keretrendszer-fejlesztőknek készült, akik a System.Windows.Automation névtérben definiált felügyelt felhasználói felületi Automation-osztályokat szeretnék használni. A felhasználói felület automatizálásával kapcsolatos legfrissebb információkért lásd Windows Automation API: UI Automation.
Ez a témakör információkat kínál az Eszköztipp vezérlőtípus UI Automation-támogatásáról. A felhasználói felület automatizálásában a vezérlőtípusok olyan feltételek, amelyeknek egy vezérlőnek meg kell felelnie a ControlTypeProperty tulajdonság használatához. A feltételek konkrét irányelveket tartalmaznak a felhasználói felület automation fastruktúrájához, a felhasználói felület automation tulajdonságértékeihez és a szabályozási mintákhoz.
Az eszköztipp-vezérlők olyan előugró ablakok, amelyek szöveget tartalmaznak.
A következő szakaszok határozzák meg a szükséges UI automatizálási fastruktúrát, tulajdonságokat, vezérlőmintákat és eseményeket a ToolTip vezérlő típushoz. A felhasználói felület automatizálására vonatkozó követelmények az összes eszköztipp-vezérlőre vonatkoznak, legyen az a Windows Presentation Foundation (WPF), a Win32 vagy a Windows Forms.
A felhasználói felület automatizálásának szükséges faszerkezete
Az alábbi táblázat a felhasználói felület automatizálási fájának vezérlőnézetét és tartalomnézetét mutatja be, amely az eszköztipp-vezérlőkre vonatkozik, és leírja, hogy az egyes nézetek mit tartalmazhatnak. A felhasználói felület automatizálási fájával kapcsolatos további információkért tekintse meg a felhasználói felület automatizálási fájának áttekintését.
| Vezérlőnézet | Tartalomnézet |
|---|---|
| Eszköztipp - Szöveg (0 vagy több) - Kép (0 vagy több) |
Eszköztipp |
Az eszköztipp-vezérlők csak akkor jelennek meg a felhasználói felület automation fa tartalomnézetében, ha a billentyűzetfókuszt megkapják. Ellenkező esetben az eszköztipp összes információja elérhető a HelpTextProperty felhasználói felület Automation eleméről, amelyre az eszköztipp hivatkozik.
Az eszköztippek azon vezérlő alatt jelennek meg, amelyekre az adataik hivatkoznak. Az ügyfeleknek figyelniük kell arra ToolTipOpenedEvent , hogy következetesen szerezzék be az eszköztippekben található információkat.
A felhasználói felület automatizálásának szükséges tulajdonságai
Az alábbi táblázat felsorolja azokat a felhasználói felületi automatizálási tulajdonságokat, amelyek értéke vagy definíciója különösen releváns az eszköztipp-vezérlők szempontjából. További információ a felhasználói felület automatizálási tulajdonságairól: UI Automation Properties for Clients.
| Felhasználói felület automatizálási tulajdonsága | Érték | Jegyzetek |
|---|---|---|
| AutomationIdProperty | Lásd a jegyzeteket. | A tulajdonság értékének egyedinek kell lennie az alkalmazás összes vezérlőjében. |
| BoundingRectangleProperty | Lásd a jegyzeteket. | A teljes vezérlőt tartalmazó legkülső téglalap. |
| ClickablePointProperty | Lásd a jegyzeteket. | A kattintható résznek az eszközleírás azon részének kell lennie, amely elrejti a vezérlőt. Egyes eszköztippek nem rendelkeznek ezzel a képességgel, és nem lesz kattintható pontjuk. |
| IsKeyboardFocusableProperty | Lásd a jegyzeteket. | Ha a vezérlő képes fogadni a billentyűzetfókuszt, támogatnia kell ezt a tulajdonságot. |
| NameProperty | Lásd a jegyzeteket. | Az eszköztipp vezérlőelem neve az a szöveg, amely az eszköztippben jelenik meg. |
| LabeledByProperty | Null |
Az eszköztipp-vezérlőket mindig a tartalmuk címkézi. |
| ControlTypeProperty | Eszköztipp | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | eszköztipp | Az Elemleírás vezérlőelem típusának megfelelő honosított sztring. |
| IsContentElementProperty | Attól függ. | Ha az eszköztipp vezérlő képes fogadni a billentyűzetfókuszt, annak a fa Tartalomnézetében kell lennie. Ha csak szövegről van szó, akkor az azt felhozó vezérlő súgószöveg-segédjeként érhető el. |
| IsControlElementProperty | Igaz | A szerszámhegy vezérlőelemnek mindig vezérlőnek kell lennie. |
A felhasználói felület automatizálásának szükséges szabályozási mintái
Az alábbi táblázat felsorolja azokat a felhasználói felületi automatizálási vezérlőmintákat, amelyeket az eszköztipp-vezérlőknek támogatniuk kell. További információ a vezérlőmintákról: felhasználói felület automatizálási vezérlőmintáinak áttekintése.
| Vezérlőminta | Támogatás | Jegyzetek |
|---|---|---|
| IWindowProvider | Attól függ. | A felhasználói felületi elemekre kattintva bezárható eszköztippek támogatják a WindowPatternt, hogy azok automatikusan bezárhatók legyenek. |
| ITextProvider | Attól függ. | A jobb hozzáférhetőség érdekében az eszköztipp-vezérlő támogathatja a Szöveg vezérlési mintát, bár ez nem kötelező. A Szöveg vezérlőelem minta akkor hasznos, ha a szöveg gazdag stílust és attribútumokat tartalmaz (például szín, félkövér és dőlt). |
Kötelező felhasználói felület automatizálási eseményei
Az eszköztipp-vezérlőknek fel kell emelniük a ToolTipOpenedEvent képernyőn való megjelenésükkor. Az esemény magában foglalja az eszköztipp UI Automation elemére mutató hivatkozást.
Az alábbi táblázat felsorolja azokat a felhasználói felületi automatizálási eseményeket, amelyeket az összes eszköztipp-vezérlőnek támogatnia kell. Az eseményekkel kapcsolatos további információkért tekintse meg a felhasználói felület automatizálási eseményeinek áttekintését.
| Felhasználói felület automatizálási eseménye | Támogatás | Jegyzetek |
|---|---|---|
| TextSelectionChangedEvent | Attól függ. | Egyik sem |
| TextChangedEvent | Attól függ. | Egyik sem |
| WindowClosedEvent | Attól függ. | Egyik sem |
| WindowOpenedEvent | Attól függ. | Egyik sem |
| ToolTipOpenedEvent | Kötelező | Egyik sem |
| ToolTipClosedEvent | Kötelező | Egyik sem |
| BoundingRectangleProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| IsOffscreenProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| IsEnabledProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| NameProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| WindowVisualStateProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |