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 a képvezérlő típus UI Automation-támogatásával kapcsolatos információkat tartalmaz. 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 ikonként, információs ábráként és diagramként használt képvezérlők támogatják a képvezérlő típusát. A háttér- vagy vízjelképként használt vezérlők nem támogatják a képvezérlő típusát.
A következő szakaszok határozzák meg a szükséges felhasználói felület-automatizálási fastruktúrát, tulajdonságokat, szabályozási mintákat és eseményeket a képvezérlő típusához. A felhasználói felület automatizálási követelményei az összes képvezé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 a képvezé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 lásd a felhasználói felület automatizálási fájának áttekintését.
| Vezérlőnézet | Tartalomnézet |
|---|---|
| Kép | Kép (Attól függ, hogy a kép tartalmaz-e információt (a tulajdonság értéke IsContentElement alapján)) |
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 a képvezérlő típusa 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 képvezérlő kattintható pontjának a képvezérlő határoló téglalapján belüli pontnak kell lennie. |
| 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. | A Név tulajdonságot minden olyan képvezérlőhöz el kellérhetővé tenni, amely információt tartalmaz. Az információkhoz való programozott hozzáféréshez meg kell adni a képnek megfelelő szöveges megfelelőt. Ha a képvezérlő tisztán dekoratív, csak a felhasználói felület Automation-fa vezérlőnézetében jelenik meg, és nem szükséges nevet adni. A felhasználói felületi keretrendszereknek támogatniuk kell egy ALT vagy alternatív szöveges tulajdonságot a képeken, amelyek a keretrendszeren belül állíthatók be. Ez a tulajdonság ezután le lesz képezve a felhasználói felület automation name tulajdonságára. |
| LabeledByProperty | Lásd a jegyzeteket. | Ha van statikus szövegfelirat, akkor ennek a tulajdonságnak közzé kell tennie az adott vezérlőelemre mutató hivatkozást. |
| ControlTypeProperty | Kép | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | "kép" | A Kép vezérlőelem típusának megfelelő honosított karakterlánc. |
| IsContentElementProperty | Lásd a jegyzeteket. | A képvezérlőnek szerepelnie kell a felhasználói felület automatizálási fájának tartalomnézetében, ha olyan hasznos információkat tartalmaz, amelyek még nem jelennek meg a végfelhasználó számára. |
| IsControlElementProperty | Igaz | A képvezérlő mindig szerepel a felhasználói felület Automation-fájának vezérlőnézetében. |
| HelpTextProperty | Lásd a jegyzeteket. | A Súgószöveg tulajdonság egy honosított sztringet tesz elérhetővé, amely leírja a vezérlő tényleges vizuális megjelenését (például egy piros négyzetet fehér X betűvel), vagy a képhez társított egyéb elemleírás-információkat. Ezt a tulajdonságot akkor kell támogatni, ha hosszú leírásra van szükség a képvezérlővel kapcsolatos további információk továbbításához. Például egy bonyolult grafikon vagy diagram. Ez a tulajdonság megfelel a HTML LongDesc és a Méretezhető vektorgrafika (SVG) Desc címkének. A képvezérlőkkel dolgozó fejlesztőknek támogatniuk kell egy tulajdonságot, amely lehetővé teszi a vizualizáció leírásának beállítását a vezérlőn. Ezt a tulajdonságot a UI Automation VisualDescription tulajdonsághoz kell hozzárendelni. |
| ItemStatusProperty | Lásd a jegyzeteket. | Ha a képvezérlő egy adott elem állapotadatait jeleníti meg a képernyőn, a vezérlőnek az elemen belül kell lennie. Ha a rendszerkép egy elemen belül található, az elemnek támogatnia kell az állapottulajdonságot, és megfelelő értesítéseket kell küldenie, amikor az állapot megváltozik. Ha a rendszerkép önálló vezérlő, és az állapotot közvetíti, ezt a tulajdonságot támogatni kell. |
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 összes képvezérlőnek támogatnia kell. A vezérlőmintákról további információt a UI-automatizálás Vezérlőminták áttekintése című témakörben talál.
| Vezérlőminta | Támogatás | Jegyzetek |
|---|---|---|
| IGridItemProvider | Attól függ. | A képvezérlő támogatja a Rácselem mintát, ha a vezérlő rácstárolón belül található. |
| ITableItemProvider | Attól függ. | A képvezérlő támogatja a Táblázatelem mintát, ha a vezérlő fejlécvezérlőkkel rendelkező tárolóban található. |
| IInvokeProvider | Soha | Ha a képvezérlő kattintható képet tartalmaz, a vezérlőnek támogatnia kell egy olyan vezérlőtípust, amely támogatja a meghívási mintát, például a Gomb vezérlőelem típusát. |
| ISelectionItemProvider | Soha | A képvezérlőknek nem kellene támogatniuk a kijelölési elemmintát. |
Kötelező felhasználói felület automatizálási eseményei
Az alábbi táblázat felsorolja azokat a felhasználói felületi automatizálási eseményeket, amelyeket az összes képvezérlőnek támogatnia kell. További információ az eseményekről: felhasználói felületi automatizálási események áttekintése.
| Felhasználói felület automatizálási eseménye | Támogatás | Jegyzetek |
|---|---|---|
| InvokedEvent | Soha | Egyik sem |
| ElementAddedToSelectionEvent | Soha | Egyik sem |
| ElementRemovedFromSelectionEvent | Soha | Egyik sem |
| ElementSelectedEvent | Soha | 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 |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |