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 gombvezé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 automatizálási fastruktúrájához, a felhasználói felület automation tulajdonságértékeihez, a vezérlési mintákhoz és a felhasználói felület automatizálási eseményeihez.
A gomb egy olyan objektum, amellyel a felhasználó műveleteket hajthat végre, például az OK és a Mégse gombot egy párbeszédpanelen. A gombvezérlő egy egyszerű, közzéteendő vezérlő, mivel egyetlen parancsra van leképzve, amelyet a felhasználó végre szeretne hajtani.
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, vezérlőmintákat és eseményeket a gombvezérlő típusához. A felhasználói felület automatizálási követelményei az összes gombvezé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 gombvezé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 |
|---|---|
| Gomb - Kép (0 vagy több) - Szöveg (0 vagy több) |
Gomb |
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 gombvezérlő típusát (például gombvezérlőket) megvalósító vezé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 |
|---|---|---|
| AcceleratorKeyProperty | Lásd a jegyzeteket. | A gombvezérlőnek általában támogatnia kell egy gyorsítókulcsot, hogy a végfelhasználó gyorsan végrehajthassa az általa képviselt műveletet a billentyűzetről. |
| 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. |
| ControlTypeProperty | Gomb | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| HelpTextProperty | Lásd a jegyzeteket. | A súgószöveg jelzi, hogy mi lesz a gomb aktiválásának végeredménye. Ez általában ugyanaz az információtípus, amelyet súgóablakon keresztül jelenítünk meg. |
| IsContentElementProperty | Igaz | A Gomb vezérlőelemnek mindig tartalmaznia kell tartalmat. |
| IsControlElementProperty | Igaz | A Gomb vezérlőelemnek mindig vezérlőnek kell lennie. |
| IsKeyboardFocusableProperty | Lásd a jegyzeteket. | Ha a vezérlő képes fogadni a billentyűzetfókuszt, támogatnia kell ezt a tulajdonságot. |
| LabeledByProperty | Null |
A gombvezérlőket a tartalmaik saját címkével jelölik. |
| LocalizedControlTypeProperty | "gomb" | Gomb vezérlés típusának megfelelő lokalizált karakterlánc. |
| NameProperty | Lásd a jegyzeteket. | A gombvezérlő neve a felirathoz használt szöveg. Amikor egy képet használ egy gomb címkézéséhez, alternatív szöveget kell megadni a gomb Név tulajdonságához. |
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 az összes gombvezérlőnek támogatnia 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 |
|---|---|---|
| IInvokeProvider | Lásd a jegyzeteket. | Az összes gombnak támogatnia kell a meghívási vezérlőmintát vagy a Kapcsolóvezérlési mintát. A meghívás akkor támogatott, ha a gomb parancsot hajt végre a felhasználó kérésére. Ez a parancs egyetlen műveletre képez le, például kivágásra, másolásra, beillesztésre vagy törlésre. |
| IToggleProvider | Lásd a jegyzeteket. | Az összes gombnak támogatnia kell a meghívási vezérlőmintát vagy a Kapcsolóvezérlési mintát. A kapcsoló akkor támogatott, ha a gomb legfeljebb három állapotból álló sorozaton keresztül váltható. Ez általában bizonyos funkciók be- és kikapcsolási kapcsolójaként jelenik meg. |
| IExpandCollapseProvider | Lásd a jegyzeteket. | Ha egy gomb egy osztott gomb gyermekeként van üzemeltetve, a gyermek gomb a Hívás vagy a Váltás minta helyett az ExpandCollapse mintát is támogathatja. A ExpandCollapse minta használható menü vagy a gombelemhez társított egyéb alstruktúra megnyitásához vagy bezárásához. |
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 gombvezé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 |
|---|---|---|
| AutomationFocusChangedEvent | Kötelező | 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 |
| NameProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |
| InvokedEvent | Attól függ. | Ha a vezérlő támogatja a meghívási vezérlőmintát, támogatnia kell ezt az eseményt. |
| ToggleStateProperty tulajdonság-változás esemény. | Attól függ. | Ha a vezérlő támogatja a kapcsolóvezérlési mintát, támogatnia kell ezt az eseményt. |