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 dokumentumvezé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 dokumentumvezérlők lehetővé teszik, hogy a felhasználók több oldalnyi szöveget tekinthessenek meg és módosítsanak. A szerkesztési vezérlőkkel ellentétben, amelyek csak egyszerű sornyi formázatlan szöveget támogatnak, a dokumentumvezérlők gazdag stílusú és formázott szöveget tartalmazhatnak.
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 Dokumentum vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes dokumentumvezé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 dokumentumvezé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 lásd a felhasználói felület automatizálási fájának áttekintését.
| Vezérlőnézet | Tartalomnézet |
|---|---|
| Dokumentum - Változik |
Dokumentum - Változik |
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 dokumentumvezé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 dokumentum egy kattintható ponttal rendelkezik, amely miatt a dokumentumtároló egyik elemének dokumentuma fókuszba kerül. |
| ControlTypeProperty | Dokumentum | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| IsContentElementProperty | Igaz | A dokumentumvezérlő mindig szerepel a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A dokumentumvezérlő mindig szerepel a felhasználói felület Automation-fa 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. | A tulajdonság értékének a dokumentumvezérlő címkéjének kell lennie. A rendszer általában a dokumentum címét használja. |
| LocalizedControlTypeProperty | "dokumentum" | A dokumentumvezérlő elem típusának megfelelő honosított lánc. |
| NameProperty | Lásd a jegyzeteket. | A dokumentumvezérlő általában abból a fájlnévből szerzi be a nevét, amelyből betöltődik. Ez gyakran megjelenik egy ablak vagy keret címében. |
A felhasználói felület automatizálásának szükséges szabályozási mintái
Az alábbi táblázat a dokumentumvezérlők által támogatott felhasználói felületi automatizálási vezérlőmintákat sorolja fel. 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 |
|---|---|---|
| IScrollProvider | Attól függ. | A dokumentumvezérlő nagyobb méretűre is kiterjedhet, mint a nézetport. A vezérlőnek támogatnia kell a görgetési vezérlőmintát, ha a tartalom görgethető. |
| ITextProvider | Kötelező | A dokumentumvezérlő nagyobb méretűre is kiterjedhet, mint a nézetport. A vezérlőnek támogatnia kell a görgetési vezérlőmintát, ha a tartalom görgethető. |
| IValueProvider | Soha | A dokumentumvezérlő nem támogatja ezt a vezérlőmintát, mert a vezérlőelem tartalma gyakran több oldalra terjed ki. A UI Automation-ügyfeleknek szöveges információkat kell TextPattern beszerezniük egy dokumentumról. |
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 dokumentumvezé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 |
| StructureChangedEvent | Kötelező | Egyik sem |
| HorizontallyScrollableProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| HorizontalScrollPercentProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| HorizontalViewSizeProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| VerticalScrollPercentProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| VerticallyScrollableProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| VerticalViewSizeProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| InvalidatedEvent | Attól függ. | Ha a vezérlőelem támogatja a Kijelölés vezérlőmintát, támogatnia kell ezt az eseményt. |
| TextSelectionChangedEvent | Kötelező | Egyik sem |
| TextChangedEvent | Kötelező | Egyik sem |
| ValueProperty tulajdonság-változás esemény. | Soha | Egyik sem |