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 Jelölőnégyzet vezérlőtípus Microsoft 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 jelölőnégyzetek olyan állapot jelzésére szolgáló objektumok, amelyekkel a felhasználók kapcsolatba léphetnek az adott állapotban való váltáshoz. A jelölőnégyzetek vagy bináris (Igen/Nem), (Be/Ki) vagy harmadlagos (Be, Ki, Határozatlan) beállítást mutatnak a felhasználó számára.
A következő szakaszok határozzák meg a jelölőnégyzet vezérlőtípushoz szükséges felhasználói felület-automatizálási fastruktúrát, tulajdonságokat, vezérlőmintákat és eseményeket. A felhasználói felület automatizálására vonatkozó követelmények az összes jelölőnégyzet-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 jelölőnégyzetvezérlőkhöz tartozó 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 tekintse meg a felhasználói felület automatizálási fájának áttekintését.
| Vezérlőnézet | Tartalomnézet |
|---|---|
| Jelölőnégyzet | Jelölőnégyzet |
Megjegyzés:
A jelölőnégyzetekben soha nem jelennek meg gyermekelemek a vezérlő- vagy tartalomnézetben. Ha a vezérlőnek gyermekelemeket kell tartalmaznia, az azt jelzi, hogy egy másik vezérlőtípust kell használni.
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 fontos a jelölőnégyzetvezé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. |
| ControlTypeProperty | Jelölőnégyzet | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| IsContentElementProperty | Igaz | A tulajdonság értékének mindig Igaznak kell lennie. Ez azt jelenti, hogy a jelölőnégyzet vezérlőelemnek mindig szerepelnie kell a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A tulajdonság értékének mindig Igaznak kell lennie. Ez azt jelenti, hogy a jelölőnégyzet vezérlőjének mindig szerepelnie kell a felhasználói felület automatizálási 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 | Null |
A jelölőnégyzetek öncímkés vezérlők. |
| LocalizedControlTypeProperty | jelölőnégyzet | A Jelölőnégyzet vezérlőelem típusának megfelelő honosított sztring. |
| NameProperty | Lásd a jegyzeteket. | A jelölőnégyzet vezérlőelem Name tulajdonságának értéke az a szöveg, amely a négyzet mellett jelenik meg, és fenntartja a váltóállapotot. |
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 jelölőnégyzetvezérlőnek támogatnia kell. 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 |
|---|---|---|
| IToggleProvider | Kötelező | Lehetővé teszi, hogy a jelölőnégyzet programozott módon váltsa át a belső állapotá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 jelölőnégyzetvezé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 |
| IsOffscreenProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| IsEnabledProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |
| ToggleStateProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
Alapértelmezett művelet
A jelölőnégyzet alapértelmezett művelete, hogy a választógomb fókuszba kerül, és az aktuális állapotot váltja ki. Ahogy korábban említettük, a jelölőnégyzetek vagy bináris (Igen/Nem) (Be/Ki) döntést adnak a felhasználónak, vagy harmadlagos (Be, Ki, Határozatlan). Ha a jelölőnégyzet bináris, az alapértelmezett művelet hatására a "be" állapot "ki" vagy "ki" állapotúvá válik. Harmadlagos állapotú jelölőnégyzetben az alapértelmezett művelet a jelölőnégyzet állapotán halad végig ugyanabban a sorrendben, mintha a felhasználó egymást követő kattintásokat küldött volna a vezérlőnek.