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 szerkesztési 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 és a szabályozási mintákhoz.
A szerkesztési vezérlők lehetővé teszik, hogy a felhasználók részletes formázási támogatás nélkül tekinthessék meg és szerkeszthessék az egyszerű szövegsorokat.
A következő szakaszok határozzák meg a felhasználói felület automatizálásának szükséges fastruktúráját, tulajdonságait, szabályozási mintáit és eseményeit a Szerkesztés vezérlőtípushoz. A felhasználói felület automatizálási követelményei az összes szerkesztési 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 vezérlők szerkesztésére 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 |
|---|---|
| Szerkeszt | Szerkeszt |
A Szerkesztés vezérlőtípust megvalósító vezérlők mindig nulla görgetősávokkal rendelkeznek a felhasználói felület Automation-fa vezérlőnézetében, mivel ez egy egysoros vezérlő. Az egysoros szöveg egyes elrendezési forgatókönyvekben tördelhető. A Szerkesztés vezérlőtípus alkalmas kis mennyiségű szerkeszthető vagy kijelölhető szöveg megtartásá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 fontos a vezérlők szerkesztéséhez. 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. | A szerkesztési vezérlőnek olyan kattintható ponttal kell rendelkeznie, amely a vezérlő szerkesztési részére összpontosít, amikor a felhasználó az egérre kattint. |
| 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 szerkesztési vezérlő neve általában statikus szövegcímkéből jön létre. Ha nincs statikus szöveges címke, az alkalmazás fejlesztőjének Name hozzá kell rendelnie egy tulajdonságértéket. A Name tulajdonságnak soha nem szabad tartalmaznia a szerkesztési vezérlő szöveges tartalmát. |
| LabeledByProperty | Lásd a jegyzeteket. | Ha a vezérlőelemhez statikus szövegcímke van társítva, akkor ennek a tulajdonságnak közzé kell tennie a vezérlőre mutató hivatkozást. Ha a szöveg vezérlőelem egy másik vezérlőelem alösszetevője, akkor nem lesz LabeledBy tulajdonságkészlete. |
| ControlTypeProperty | Szerkeszt | Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik. |
| LocalizedControlTypeProperty | "szerkesztés" | Az „Szerkesztés” vezérlőtípusnak megfelelő honosított lánc. |
| IsContentElementProperty | Igaz | A szerkesztési vezérlő mindig szerepel a felhasználói felület automatizálási fa tartalomnézetében. |
| IsControlElementProperty | Igaz | A szerkesztési vezérlő mindig szerepel a felhasználói felület automatizálási fa vezérlőnézetében. |
| IsPasswordProperty | Lásd a jegyzeteket. | A jelszavakat tartalmazó szerkesztési vezérlők esetében igaz értékre kell állítani. Ha a szerkesztési vezérlő nem tartalmaz jelszótartalmat, akkor ezt a tulajdonságot a képernyőolvasó használhatja annak meghatározására, hogy a felhasználó gépelésével ki kell-e olvasni a billentyűleütéseket. |
A felhasználói felület automatizálásához szükséges vezérlőminták és tulajdonságok
Az alábbi táblázat felsorolja azokat a szabályozási mintákat, amelyeket az összes szerkesztési vezé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/Vezérlőminta tulajdonság | Támogatás/érték | Jegyzetek |
|---|---|---|
| ITextProvider | Attól függ. | A szerkesztési vezérlőknek támogatniuk kell a Szöveg vezérlőmintát, mert a részletes szöveges információknak mindig elérhetőknek kell lenniük az ügyfelek számára. |
| IValueProvider | Attól függ. | A sztringet használó összes szerkesztési vezérlőnek el kell fednie az Érték mintát. |
| IsReadOnly | Lásd a jegyzeteket. | Ezt a tulajdonságot úgy kell beállítani, hogy jelezze, hogy a vezérlő programozott módon vagy a felhasználó által szerkeszthető értékhalmazsal rendelkezhet-e. |
| Value | Lásd a jegyzeteket. | Ez a tulajdonság a szerkesztési vezérlő szöveges tartalmát adja vissza. Ha a IsPasswordProperty értéke true, akkor ennek a tulajdonságnak igény esetén ki kell váltania egy InvalidOperationException eseményt. |
| IRangeValueProvider | Attól függ. | A számtartományt használó szerkesztési vezérlőknek el kellérhetővé tenniük a tartományérték-vezérlési mintát. |
| Minimum | Lásd a jegyzeteket. | Ennek a tulajdonságnak a legkisebb értéknek kell lennie, amelybe a szerkesztési vezérlő tartalma beállítható. |
| Maximum | Lásd a jegyzeteket. | Ennek a tulajdonságnak kell lennie a szerkesztési vezérlő tartalmának legnagyobb értékének. |
| SmallChange | Lásd a jegyzeteket. | Ennek a tulajdonságnak azt a tizedesjegyet kell megadnia, amelyekre az érték beállítható. Ha a szerkesztés csak egész számokat vesz fel, az SmallChangeProperty 1-nek kell lennie. Ha a szerkesztés 1,0 és 2,0 közötti tartományt vesz igénybe, akkor az SmallChangeProperty értéknek 0,1-nek kell lennie. Ha a szerkesztési vezérlő 1,00 és 2,00 közötti tartományt vesz igénybe, akkor az SmallChangeProperty értéknek 0,001-nek kell lennie. |
| LargeChange | Null |
Ezt a tulajdonságot nem kell egy szerkesztési vezérlőn elérhetővé tenni. |
| Value | Lásd a jegyzeteket. | Ez a tulajdonság a szerkesztési vezérlő numerikus tartalmát jelzi. Ha egy felhasználói felület automation-ügyfele pontosabb értéket állít be a megadott tartományokon MinimumMaximum belül, az Érték tulajdonság automatikusan a legközelebbi elfogadott értékre lesz kerekítve. |
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 szerkesztési vezé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 |
|---|---|---|
| InvalidatedEvent | Kötelező | Egyik sem |
| 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. | Attól függ. | 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. | Ha a vezérlőelem támogatja a tartományérték-vezérlési mintát, támogatnia kell ezt az eseményt. |
| AutomationFocusChangedEvent | Kötelező | Egyik sem |
| StructureChangedEvent | Kötelező | Egyik sem |