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 táblavezérlő típusának 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.
A táblázatvezérlők szövegsorokat és oszlopokat, valamint opcionálisan sorfejléceket és oszlopfejléceket tartalmaznak.
A következő szakaszok határozzák meg a táblavezérlő típusához 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 felhasználói felület automatizálási követelményei az összes táblavezé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 táblázatvezé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 |
|---|---|
| Táblázat - Fejléc (0 vagy 1) - Szöveg (0 vagy 1) - Különböző vezérlők (0 vagy több) |
Táblázat - Szöveg (0 vagy több) - Különböző vezérlők (0 vagy több) |
Ha egy táblázatvezérlő sor- vagy oszlopfejlécekkel rendelkezik, azokat a felhasználói felület Automation-fa Vezérlő nézetében kell megjeleníteni. A Tartalom nézetnek nem kell elérhetővé tennie ezeket az információkat, mert az a TablePattern használatával érhető el.
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 Táblázatvezé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 táblázatvezérlő általában egy statikus szövegfeliratból kapja meg a nevét. Ha nincs statikus szövegfelirat, olyan Név tulajdonságot kell hozzárendelnie, amely mindig elérhető a tábla céljának magyarázatához. |
| LabeledByProperty | Lásd a jegyzeteket. | Statikus szövegfelirat esetén ennek a tulajdonságnak a vezérlő automatizálási elemére kell hivatkoznia. |
| ControlTypeProperty | Táblázat | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | asztal | A Táblázat vezérlőelem típusának megfelelő honosított karakterlánc. |
| HelpTextProperty | Lásd a jegyzeteket. | A tábla céljával kapcsolatos további részleteket ezen a tulajdonságon keresztül kell ismertetni, ha a NameProperty elérése nem magyarázza meg megfelelően. |
| IsContentElementProperty | Igaz | A táblázatvezérlőnek mindig tartalmaznia kell tartalmat. |
| IsControlElementProperty | Igaz | A táblavezérlőnek mindig vezérlőnek kell lennie. |
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 táblavezé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 | Támogatás | Jegyzetek |
|---|---|---|
| IGridProvider | Igen | A táblavezérlő mindig támogatja ezt a vezérlőmintát, mert a benne lévő elemek rácsban megjelenített adatokkal rendelkeznek. |
| IGridItemProvider | Igen (gyermekobjektumokhoz szükséges) | A táblázat belső objektumainak támogatniuk kell a GridItem és a TableItem vezérlőmintákat is. Magának a táblának nem kell támogatnia a GridItem vagy TableItem vezérlőmintákat, kivéve, ha a tábla egy másik tábla része. |
| ITableProvider | Igen | A táblavezérlő mindig rendelkezik a tartalomhoz társított fejlécekkel. |
| ITableItemProvider | Igen (gyermekobjektumokhoz szükséges) | A táblázat belső objektumainak támogatniuk kell a GridItem és a TableItem vezérlőmintákat is. Magának a táblának nem kell támogatnia a GridItem vagy TableItem vezérlőmintákat, kivéve, ha a tábla egy másik tábla része. |
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 táblavezé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 |
|---|---|---|
| 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 |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |