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 fa 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 automatizálási fastruktúrájához, a felhasználói felület automation tulajdonságértékeihez és a szabályozási mintákhoz.
A fa vezérlőtípust olyan tárolókhoz használják, amelyek tartalma csomópontok hierarchiájaként van relevanciája, ahogyan a fájlok és mappák a Microsoft Windows Explorer bal oldali ablaktábláján jelennek meg. Minden csomópont tartalmazhat más csomópontokat, úgynevezett gyermekcsomópontokat. A szülőcsomópontok vagy a gyermekcsomópontokat tartalmazó csomópontok kibontott vagy összecsukottként jeleníthetők meg.
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 fa vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes favezé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 favezérlőkre vonatkozó felhasználói felületi Automation-fa vezérlőnézetét és tartalomnézetét mutatja be, és ismerteti az egyes nézetekben található elemeket. 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 |
|---|---|
Fa
|
Fa
|
A felhasználói felület automatizálási fájának vezérlőnézete a következőkből áll:
A tárolóban nulla vagy több elem (amelyek a faelemre, adatelemre vagy más vezérlőtípusra épülhetnek).
Nulla, egy vagy két görgetősáv.
A felhasználói felület automatizálási fájának tartalomnézete nulla vagy több elemből áll a tárolóban (az elemek a faelem, az adatelem vagy más vezérlőtípus alapján lehetnek).
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 listavezé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 favezérlők egy kattintható ponttal rendelkeznek, amely miatt a fa vagy a fatároló egyik eleme fókuszba kerül. Csak akkor kap egy kattintható pontot egy fához, ha olyan helyre kattinthat, amely nem okozza az egyik elem kijelölését/fókuszba helyezését. |
| ControlTypeProperty | Fa | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| IsContentElementProperty | Igaz | A fa vezérlőelem mindig szerepel a felhasználói felület automatizálási fájának tartalomnézetében. |
| IsControlElementProperty | Igaz | A fa vezérlőelem mindig szerepel a felhasználói felület automatizálási fájának vezérlőnézetében. |
| IsKeyboardFocusableProperty | Lásd a jegyzeteket. | Ha a vezérlő képes fogadni a billentyűzetfókuszt, támogatnia kell ezt a tulajdonságot. |
| LabeledByProperty | Lásd a jegyzeteket. | Ha a fa vezérlőelemhez címke van társítva, ez a tulajdonság visszaad egy AutomationElement az adott címke azonosítójaként. Ellenkező esetben a tulajdonság null hivatkozást ad vissza (Nothing a Microsoft Visual Basic .NET-ben). |
| LocalizedControlTypeProperty | "fa" | A Lista vezérlőelem típusának megfelelő honosított karakterlánc. |
| NameProperty | Lásd a jegyzeteket. | A fa vezérlőelem névtulajdonságának értéke általában a vezérlőelemet címkéző szövegből származik. Ha nincs szöveges címke, akkor az alkalmazásfejlesztőnek meg kell adnia egy értéket ehhez a tulajdonsághoz. |
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 a listavezé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/mintatulajdonság | Támogatás/érték | Jegyzetek |
|---|---|---|
| ISelectionProvider | Attól függ. | A választható elemeket tartalmazó favezérlőknek implementálniuk kell ezt a vezérlőmintát. Ezt a vezérlőmintát nem kell implementálnunk, ha egy elem kiválasztása nem ad értelmes információt a felhasználónak. |
| CanSelectMultiple | Lásd a jegyzeteket. | Ezt a tulajdonságot akkor implementálhatja, ha a fa vezérlőelem több kijelölést is támogat (a legtöbb favezérlő nem támogatja a több kijelölést). |
| IsSelectionRequired | Lásd a jegyzeteket. | A tulajdonság értéke akkor jelenik meg, ha a vezérlőelem megköveteli egy elem kijelölését. |
| IScrollProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a fatároló tartalma 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 favezé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 |
|---|---|---|
| InvalidatedEvent | Attól függ. | 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 |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |