Megosztás a következőn keresztül:


UI Automation-támogatás a scrollbar vezérlőtípushoz

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 ScrollBar 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 automation fastruktúrájához, a felhasználói felület automation tulajdonságértékeihez és a szabályozási mintákhoz.

A görgetősáv-vezérlők lehetővé teszik a felhasználók számára, hogy egy ablakban vagy elemtárolóban görgethessék a tartalmat. A vezérlő gombokból és hüvelykujj-vezérlőkből áll.

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 ScrollBar vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes listavezé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 görgetősáv-vezé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 tekintse meg a felhasználói felület automatizálási fájának áttekintését.

Vezérlőnézet Tartalomnézet
Görgetősáv

- Gomb (2 vagy 4)
- Hüvelykujj (0 vagy 1)
Nem alkalmazható. A görgetősáv vezérlőelem nem tartalmaz tartalmat.

A görgetősáv vezérlőelemnek mindig három-öt gyermeke van. Mivel a részhalmaz több gombvezérlővel is rendelkezik, minden elemhez be kell állítania egy adott AutomationIdProperty értéket, hogy azok felderíthetők legyenek a tesztautomatizálási eszközök számára.

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 görgetősáv-vezérlők szempontjából. Vegye figyelembe, hogy a görgetősávok soha nem tartalmaznak tartalmat; funkciójukat a görgetési vezérlő mintán keresztül lehet elérni, amely a görgetett tárolón támogatott.

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.
IsKeyboardFocusableProperty Lásd a jegyzeteket. Ha a vezérlő képes fogadni a billentyűzetfókuszt, támogatnia kell ezt a tulajdonságot.
NameProperty Null A görgetősáv vezérlőelem nem rendelkezik tartalomelemekkel, és nincs szükség a NameProperty beállításra.
ClickablePointProperty Nem szám. A görgetősáv vezérlőelem nem rendelkezik kattintható ponttal.
LabeledByProperty Null A görgetősávok nem rendelkeznek címkékkel.
ControlTypeProperty Görgetősáv Ez az érték minden keretrendszer esetében megegyezik. A csúszkaként működő görgetősávoknak a Csúszka vezérlőtípust kell használniuk.
LocalizedControlTypeProperty "görgetősáv" A Gomb vezérlő típusának megfelelő honosított karakterlánc.
IsContentElementProperty Téves A görgetősáv vezérlőelem soha nem tartalomelem. Ha a görgetősáv önálló vezérlő, akkor meg kell felelnie a Csúszka vezérlőelem típusának, és a ControlType.Slider tulajdonsághoz ControlType értéket kell adnia vissza.
IsControlElementProperty Igaz A görgetősávnak mindig vezérlőnek kell lennie.
OrientationProperty Igaz A görgetősáv vezérlőelemnek mindig el kell fednie a vízszintes vagy függőleges tájolásá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 a görgetősáv-vezérlők által támogatott UI Automation-vezérlőmintákat. További információ a vezérlőmintákról: felhasználói felület automatizálási vezérlőmintáinak áttekintése. Vegye figyelembe, hogy ha a görgetősávot csak egér-manipuláció vezérlőjeként használják, az nem támogatja a vezérlőmintákat. Ha egy alkalmazáson belül csúszkavezérlőként használják, a csúszka vezérlőelem típusát kell megadnia.

Vezérlőminta Támogatás Jegyzetek
IScrollProvider Soha A görgetési vezérlő minta soha nem támogatott közvetlenül a görgetősávon.
IRangeValueProvider Attól függ. Ezt a funkciót csak akkor kell támogatni, ha a görgetősávot tartalmazó tároló nem támogatja a görgetési vezérlő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 görgetősáv-vezé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/érték 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
HorizontallyScrollableProperty tulajdonság-változás esemény. Soha Egyik sem
HorizontalScrollPercentProperty tulajdonság-változás esemény. Soha Egyik sem
HorizontalViewSizeProperty tulajdonság-változás esemény. Soha Egyik sem
VerticalScrollPercentProperty tulajdonság-változás esemény. Soha Egyik sem
VerticallyScrollableProperty tulajdonság-változás esemény. Soha Egyik sem
VerticalViewSizeProperty tulajdonság-változás esemény. Soha Egyik sem
ValueProperty tulajdonság-változás esemény. Attól függ. Egyik sem
AutomationFocusChangedEvent Kötelező Egyik sem
StructureChangedEvent Kötelező Egyik sem

Lásd még