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 panel vezérlőtípus felhasználói felületi automatizálási 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 Ablaktábla vezérlőtípus egy kereten vagy dokumentumablakon belüli objektum ábrázolására szolgál. A felhasználók az ablaktábla vezérlői között és az aktuális panel tartalmán belül navigálhatnak, de nem navigálhatnak a különböző ablaktáblák elemei között. Az ablaktábla-vezérlők tehát alacsonyabb csoportosítási szintet képviselnek, mint az ablakok vagy dokumentumok, de az egyes vezérlők felett. A felhasználó a tabulátor, az F6 vagy a CTRL+TAB billentyűkombináció lenyomásával navigál a panelek között a környezettől függően. A panel vezérlőtípusa nem igényel konkrét billentyűzet-navigáció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 panel vezérlőtípusához. A felhasználói felület automatizálási követelményei az összes listavezé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 Automation-fájának vezérlőnézetét és tartalomnézetét mutatja be, amely a panelvezé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 |
|---|---|
| Panel | Panel |
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 Automation-tulajdonságokat, amelyek értéke vagy definíciója különösen releváns a panelvezé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. |
| 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 tulajdonság értékének mindig egyértelműnek, tömörnek és értelmesnek kell lennie. |
| ClickablePointProperty | Lásd a jegyzeteket. | Ez a tulajdonság a panel vezérlőelem egy kattintható pontját teszi elérhetővé, amely miatt a panel fókuszba kerül a kattintáskor. |
| LabeledByProperty | Lásd a jegyzeteket. | A panelvezérlők általában nem rendelkeznek statikus címkével. Ha van statikus szövegfelirat, akkor ezt a tulajdonságot kell elérnie. |
| ControlTypeProperty | Panel | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | üvegtábla | A panel vezérlőelem számára megfelelő honosított karakterlánc. |
| IsContentElementProperty | Igaz | A panelvezérlők mindig szerepelnek a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A panelvezérlők mindig szerepelnek a felhasználói felület automatizálási fa vezérlőnézetében. |
| HelpTextProperty | "" | A panelvezérlők súgószövegének meg kell magyaráznia, hogy a keret célja és hogyan kapcsolódik más keretekhez. Leírásra akkor van szükség, ha a keretek célja és kapcsolata nem egyértelmű a NameProperty értékéből. „ |
| AccessKeyProperty | Lásd a jegyzeteket. | Ha egy adott billentyűkombináció a panelre helyezi a fókuszt, akkor az információkat ezen a tulajdonságon keresztül kell felfedni. |
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 panelvezérlőnek támogatnia 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 |
|---|---|---|
| ITransformProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a panel vezérlőeleme áthelyezhető, átméretezhető vagy elforgatható a képernyőn. |
| IWindowProvider | Soha | Ha ezt a vezérlőmintát kell implementálnia, a vezérlőnek a Window vezérlő típusán kell alapulnia. |
| IDockProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a panel vezérlőelem rögzíthető. |
| IScrollProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a panel vezérlőelem görgethető. |
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 panelvezé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/érték | Jegyzetek |
|---|---|---|
| WindowClosedEvent | Soha | Egyik sem |
| WindowOpenedEvent | Soha | Egyik sem |
| AsyncContentLoadedEvent | 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 |
| HorizontallyScrollableProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| HorizontalScrollPercentProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| HorizontalViewSizeProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| VerticalScrollPercentProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| VerticallyScrollableProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| VerticalViewSizeProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| WindowVisualStateProperty tulajdonság-változás esemény. | Soha | Egyik sem |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |
Példa ablaktábla vezérlőelemtípusára
Az alábbi képen egy olyan vezérlő látható, amely megvalósítja a Panel vezérlőelem típusát.
| Felhasználói felület automatizálási fa – Vezérlőnézet | Felhasználói felület automatizálási fa – Tartalomnézet |
|---|---|
|
- Üveg - Fa (görgetési minta) - TreeItem - … Táblaüveg -Szerkeszt - (Görgetési minta) |