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

A szövegvezérlő típus felhasználói felületi automatizálásának támogatása

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 szövegvezérlő típus 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 szövegvezérlők az alapvető felhasználói felületi elemek, amelyek egy szövegrészt jelölnek a képernyőn.

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, szabályozási mintákat és eseményeket a Szöveg vezérlőelem típusához. A felhasználói felület automatizálási követelményei az összes szövegvezé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 szövegvezé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
Szöveg Szöveg (ha tartalom)

A szövegvezérlők önállóan használhatók címkeként vagy statikus szövegként egy űrlapon. Az alábbiak szerkezetében is szerepelhet:

  • Listaelem

  • TreeItem

  • DataItem

Előfordulhat, hogy a szövegvezérlők nem szerepelnek az UI Automation fa tartalomnézetében, mert a szöveg gyakran egy másik vezérlőn keresztül NameProperty jelenik meg. Például a kombinált lista vezérlő címkézéséhez használt szöveg a vezérlő NameProperty értékén keresztül jelenik meg. Mivel a Kombinált lista vezérlőelem a felhasználói felület automatizálási fa tartalomnézetében található, nem szükséges, hogy a szövegvezérlő ott legyen. A szövegvezérlőknek mindig 0 gyermekük van a tartalomnézetben

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 szövegvezé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 szövegsáv vezérlőelem neve mindig az a szöveg, amelyet megjelenít.
LabeledByProperty Null A szövegvezérlők nem rendelkeznek statikus szövegfeliratsal.
ControlTypeProperty Szöveg Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik.
LocalizedControlTypeProperty "szöveg" A szövegvezérlő típusának megfelelő lokalizált karakterlánc.
IsContentElementProperty Attól függ. A szövegvezérlő akkor lesz tartalom, ha egy másik vezérlő NameProperty tulajdonságában nem közzétett információkat tartalmaz.
IsControlElementProperty Igaz A szövegvezé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 a szövegvezérlők által támogatott UI Automation-vezérlőmintákat sorolja fel. 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
IValueProvider Soha A szöveg soha nem támogatja a ValuePattern parancsot. Ha a szöveg szerkeszthető, akkor ez a Szerkesztés vezérlőtípus.
ITextProvider Attól függ. A szövegnek támogatnia kell a Szöveg vezérlőmintát a jobb hozzáférhetőség érdekében; azonban nem szükséges. A Szöveg vezérlőelem minta akkor hasznos, ha a szöveg gazdag stílust és attribútumokat tartalmaz (például szín, félkövér és dőlt). A keretrendszertől függ.
ITableItemProvider Attól függ. Ha a szövegelem egy Táblázat vezérlőelemben található, ezt támogatni kell.
IRangeValueProvider Attól függ. Ha a szövegelem egy táblázatvezérlőben található, ezt támogatni kell.

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 szövegvezé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
TextSelectionChangedEvent Kötelező Egyik sem
TextChangedEvent 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
ValueProperty tulajdonság-változás esemény. Soha Egyik sem
AutomationFocusChangedEvent Kötelező Egyik sem
StructureChangedEvent Kötelező Egyik sem

Lásd még

  • Last updated on