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 felhasználói felület automatizálásának csoportvezérlő-típushoz való 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 felhasználói felület automatizálásának vezérlési mintáihoz.
A csoportvezérlő egy hierarchián belüli csomópontot jelöl. A csoportvezérlő típusa különválasztást hoz létre a felhasználói felület automatizálási fájában, így a csoportosított elemek logikai osztással rendelkeznek a felhasználói felület automation fáján belül.
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 csoportvezérlő típusához. A felhasználói felület automatizálására vonatkozó követelmények az összes csoportvezé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 csoportvezé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 |
|---|---|
| Csoport - 0 vagy több vezérlő |
Csoport - 0 vagy több vezérlő |
A csoportvezérlők általában az ListItem vezérlőtípus felhasználói felület automatizálási támogatásával, a TreeItem vezérlőtípus felhasználói felület automatizálási támogatásával vagy az Adatelem vezérlőtípus felhasználói felület automatizálási támogatásával rendelkeznek, amelyek a fastruktúrában alattuk találhatók. Mivel a "Csoport" egy általános tároló, lehetséges, hogy bármilyen típusú vezérlőelem a struktúra Csoport vezérlője alá kerüljö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 csoportvezé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. | Ha van határolókeret, akkor támogatott. Ha a határoló téglalapon belül nem minden pont kattintható, és speciális találatti tesztelést végez, akkor felülbírálhatja a beállításokat, és megadhat egy kattintható pontot. |
| 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 csoportvezérlő általában a vezérlőt címkéztető szövegből kapja meg a nevét. |
| LabeledByProperty | Lásd a jegyzeteket. | A csoportvezérlők általában öncímkézést jelentenek. Ezekben az esetekben térjen vissza null ide. Ha a csoporthoz statikus szövegfelirat tartozik, akkor azt a LabeledBy tulajdonság értékeként kell visszaadni. |
| ControlTypeProperty | Csoport | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | "csoport" | A Csoport vezérlőelem típusának megfelelő honosított karakterlánc. |
| IsContentElementProperty | Igaz | A csoportvezérlő mindig szerepel a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A naptárcsoport mindig szerepel a felhasználói felület automatizálási fa vezérlőnézeté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 felsorolja a csoportvezérlő típusához szükséges UI Automation-vezérlőmintákat. 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 |
|---|---|---|
| IExpandCollapseProvider | Attól függ. | Az információk megjelenítésére vagy elrejtésére használható csoportvezérlőknek támogatniuk kell a kibontás és összecsukás mintá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 csoportvezé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 |
|---|---|---|
| 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 |
| ExpandCollapseStateProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| ToggleStateProperty tulajdonság-változás esemény. | Attól függ. | Egyik sem |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |