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 ComboBox vezérlőtípus 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 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 kombinált lista egy statikus vezérlővel vagy szerkesztési vezérlővel kombinált lista, amely a kombinált lista listamező részén az aktuálisan kijelölt elemet jeleníti meg. A vezérlő listamező-része mindig megjelenik, vagy csak akkor jelenik meg, ha a felhasználó kiválasztja a vezérlő melletti legördülő nyilat (amely egy leküldéses gomb). Ha a kijelölési mező szerkesztési vezérlő, a felhasználó olyan adatokat adhat meg, amelyek nem szerepelnek a listában; ellenkező esetben a felhasználó csak a listában szereplő elemeket választhatja ki.
A következő szakaszok határozzák meg a kívánt felhasználói felület-automatizálási fastruktúrát, tulajdonságokat, szabályozási mintákat és eseményeket a ComboBox vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes kombinált lista vezérlőelemre 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 kombinált lista vezérlőire 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 |
|---|---|
| Kombinált lista - Szerkesztés (0 vagy 1) - Lista (1) - Listaelem (a lista gyermeke; 0-ról többre) - Gomb (1) |
Kombinált lista - Listaelem (0-ról többre) |
A kombinált lista vezérlőnézetének szerkesztési vezérlője csak akkor szükséges, ha a kombinált lista bármilyen bemenethez szerkeszthető, ahogyan a Futtatás párbeszédpanelen lévő kombinált lista esetében is.
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 kombinált lista vezérlői számára. 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 | Kombinált lista | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| HelpTextProperty | Lásd a jegyzeteket. | A kombinált lista vezérlőinek súgószövegének meg kell magyaráznia, hogy a rendszer miért kéri fel a felhasználót, hogy válasszon egy lehetőséget a kombinált listából. A szöveg hasonló az elemleíráson keresztül megjelenített információkhoz. Például: "Válasszon ki egy elemet a monitor megjelenítési felbontásának beállításához". |
| IsContentElementProperty | Igaz | A kombinált lista vezérlői mindig szerepelnek a felhasználói felület Automation-fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A kombinált lista vezérlői mindig szerepelnek a felhasználói felület automatizálási fa vezérlőnézetében. |
| IsKeyboardFocusableProperty | Igaz | A kombinált doboz vezérlők egy választási listából származó elemeket tesznek elérhetővé. A kombinált lista vezérlője képes fogadni a billentyűzetfókuszt, bár amikor egy UI Automation-ügyfél beállítja a fókuszt egy kombinált listára, a kombinált lista almenüjének minden eleme megkapja a fókuszt. |
| LabeledByProperty | Lásd a jegyzeteket. | A kombinált lista vezérlői általában statikus szöveges címkével rendelkeznek, amelyekre ez a tulajdonság hivatkozik. |
| LocalizedControlTypeProperty | "kombinált lista" | A Legördülő lista vezérlőelem típusának megfelelő honosított karakterlánc. |
| NameProperty | Lásd a jegyzeteket. | A kombinált lista vezérlőelem általában egy statikus szövegvezérlőtől kapja a nevét. |
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 kombinált lista vezérlőelemnek 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 |
|---|---|---|
| IExpandCollapseProvider | Igen | A kombinált lista vezérlőelemnek mindig tartalmaznia kell a legördülő gombot ahhoz, hogy kombinált lista legyen. |
| ISelectionProvider | Igen | Megjeleníti az aktuális kijelölést a kombinált listában. Ez a támogatás delegálva van a kombinált lista alatti listamezőbe. |
| IValueProvider | Attól függ. | Ha a kombinált lista tetszőleges szöveges értékeket képes felvenni, az Érték mintát támogatni kell. Ez a minta lehetővé teszi a kombinált lista sztringtartalmának programozott beállítását. Ha az Érték minta nem támogatott, az azt jelzi, hogy a felhasználónak a kombinált lista elemei közül kell választania. |
| IScrollProvider | Soha | A görgetési minta soha nem támogatott közvetlenül a kombinált mezőben. Az támogatott, hogy a kombinált mezőben található listamező görgethető legyen. Ez csak akkor támogatott, ha a listamező látható a képernyőn. |
Szükséges események
Az alábbi táblázat felsorolja azokat a felhasználói felületi automatizálási eseményeket, amelyeket az összes kombinált listavezé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 |
| StructureChangedEvent | Kötelező | Egyik sem |
| ExpandCollapseStateProperty tulajdonság-változás esemény. | Kötelező | Egyik sem |
| ValueProperty tulajdonság-változás esemény. | Attól függ. | Ha a vezérlőelem támogatja az Érték mintát, támogatnia kell ezt az eseményt. |