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 TreeItem vezé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.
A TreeItem vezérlőtípus egy fatárolón belüli csomópontot jelöl. 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 UI Automation-fastruktúrát, tulajdonságokat, szabályozási mintákat és eseményeket a TreeItem vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes faelem-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 faelem-vezérlőkhöz tartozó felhasználói felület Automation-fájának 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 |
|---|---|
| TreeItem - Jelölőnégyzet (0 vagy 1) - Kép (0 vagy 1) - Gomb (0 vagy 1) - TreeItem (0 vagy több) |
TreeItem - TreeItem (0 vagy több) |
A faelem-vezérlőknek nulla vagy több faelem gyermekük lehet a felhasználói felület Automation-fa tartalomnézetében. Ha a faelem-vezérlő az alábbi vezérlőmintákban láthatónál több funkciót is biztosít, akkor a vezérlőnek az Adatelem vezérlőelem típusán kell alapulnia.
Az összehajtott faelemek csak akkor jelennek meg a vezérlőnézetben vagy a tartalomnézetben, ha kibontódnak és láthatóvá válnak (vagy meg lehet őket görgetni a nézetbe).
A vezérlőnézet további részleteket is tartalmazhat egy vezérlőről, beleértve a társított képet vagy egy gombot. Egy vázlatnézetben például egy elem tartalmazhat egy képet, valamint egy gombot a vázlat kibontásához vagy összecsukásához. Ezek a részletobjektumok nem jelennek meg a tartalomnézetben, mert az információkat már a szülőfaelem képviseli. A képernyőről kigörgetett faelemek megjelennek a felhasználói felület Automation-fája vezérlő- és tartalomnézetében is, és az IsOffscreenProperty értékét igazra kell állítaniuk.
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. | Ennek a tulajdonságnak az elem egy olyan helyét kell visszaadnia, amely miatt az elem megváltoztatja a kijelölési állapotát vagy fókuszált állapotba kerül. |
| ControlTypeProperty | TreeItem | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| IsContentElementProperty | Igaz | A listavezérlő mindig szerepel a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A listavezérlő mindig szerepel a felhasználói felület Automation-fa vezérlőnézetében. |
| IsOffscreenProperty | Lásd a jegyzeteket. | Ez a tulajdonság arra van beállítva, hogy jelezze, amikor egy faelem vezérlője kigurul a képernyőről. |
| IsKeyboardFocusableProperty | Lásd a jegyzeteket. | Ha a vezérlő képes fogadni a billentyűzetfókuszt, támogatnia kell ezt a tulajdonságot. |
| ItemTypeProperty | Lásd a jegyzeteket. | Ha a faelem-vezérlő vizualizáció ikonnal jelzi, hogy egy adott típusú objektumról van szó, akkor ezt a tulajdonságot támogatni kell, és jelezni kell, hogy mi az objektum. |
| LabeledByProperty | Null |
A faelem-vezérlők önfeliratozást jelentenek. |
| LocalizedControlTypeProperty | "faelem" | A TreeItem vezérlőtípusnak megfelelő honosított sztring. |
| NameProperty | Lásd a jegyzeteket. | Ez a tulajdonság az egyes faelem-vezérlőkhöz megjelenített szöveget jeleníti meg. |
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 |
|---|---|---|
| IInvokeProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a faelem külön, végrehajtható paranccsal rendelkezik. |
| IExpandCollapseProvider | Igen | Minden faelem kibontható vagy összecsukható. |
| ExpandCollapseState | Kibontott, összecsukott vagy levélcsomópont | A faelemek levélcsomópontok lesznek, ha nincsenek kibontva vagy összecsukva. |
| IScrollItemProvider | Attól függ. | Ezt a vezérlőmintát akkor implementálhatja, ha a fatároló támogatja a Görgetés vezérlőmintát. |
| ISelectionItemProvider | Attól függ. | Ezt a vezérlőmintát akkor kell alkalmazni, ha lehetséges a kijelölés megőrzése, amikor a felhasználó visszatér a fatárolóba. |
| SelectionContainer | Igen | Ez a tulajdonság ugyanazt a tárolót fogja elérhetővé tennie a tárolón belüli összes elemhez. |
| IToggleProvider | Attól függ. | Ezt a vezérlőmintát akkor hajtsa végre, ha a faelemhez társított jelölőnégyzet van. |
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 faelem-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 |
|---|---|---|
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| BoundingRectangleProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| IsEnabledProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| IsOffscreenProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| ItemStatusProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| NameProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |
| ExpandCollapseStateProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| InvokedEvent | Attól függ. | Egyik sem |
| CurrentViewProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| ElementAddedToSelectionEvent | Attól függ. | Egyik sem |
| ElementRemovedFromSelectionEvent | Attól függ. | Egyik sem |
| ElementSelectedEvent | Attól függ. | Egyik sem |
| ToggleStateProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| ValueProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |