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


Felhasználói felület automatizálásának támogatása a SplitButton 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 SplitButton 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.

Az osztott gomb vezérlője lehetővé teszi, hogy műveletet hajtson végre egy vezérlőn, és kibontsa a vezérlőt, hogy megtekintse az egyéb végrehajtható műveletek listáját.

A következő szakaszok határozzák meg a SplitButton vezérlőtípushoz 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 felhasználói felület automatizálási követelményei az összes felosztott gomb 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 felhasználói felület automatizálási fájának vezérlőnézetét és tartalomnézetét mutatja be, amely az osztott gombvezérlőkre vonatkozik, é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
Osztott gomb

  • Kép (0 vagy 1)
  • Szöveg (0 vagy 1)
  • Gomb (1 vagy 2)

    • Menü (0 vagy 1; az ExpandCollapse mintát támogató gomb gyermekeként jelenik meg)
    • MenuItem (1-ről többre)
Osztott gomb

- MenuItem (1-ről többre)

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 az osztott gombvezérlők esetében. 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 Vissza Az osztott gomb vezérlőelem neve megjelenik a gombon.
LabeledByProperty Nulla Az osztott gomb vezérlőinek nincs statikus szövegfelirata.
ControlTypeProperty Osztott gomb Ez az érték minden felhasználói felületi keretrendszer esetében megegyezik.
LocalizedControlTypeProperty "felosztás gomb" A SplitButton vezérlőtípushoz tartozó honosított karakterlánc.
HelpTextProperty Lásd a jegyzeteket. A súgószöveg az osztott gomb aktiválásának eredményét jelezheti, amely általában ugyanaz az elemleíráson keresztül megjelenített információtípus.
IsContentElementProperty Igaz Az osztott gomb vezérlőelem a végfelhasználó adatait tartalmazza.
IsControlElementProperty Igaz Az osztott gomb vezérlőelem látható a végfelhasználó számára.

A felhasználói felület automatizálásának szükséges szabályozási mintái

Az alábbi táblázat azokat a felhasználói felületi automatizálási vezérlőmintákat sorolja fel, amelyeket az osztott gomb vezérlőinek támogatniuk 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
IInvokeProvider Kötelező Az osztott gombokhoz mindig tartozik egy alapértelmezett művelet a meghíváshoz.
IExpandCollapseProvider Kötelező Az osztott gombok mindig ki tudják bontani a lehetőségek listájá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 felosztott gomb vezérlőjé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
InvokedEvent 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
ExpandCollapseStateProperty tulajdonság-változás esemény. Kötelező Egyik sem
AutomationFocusChangedEvent Kötelező Egyik sem
StructureChangedEvent Kötelező Egyik sem

Példa SplitButton vezérlőelemre

Az alábbi képen egy SplitButton típusú vezérlő látható egy adatrács-vezérlőben.

Felosztás gomb

Az alább látható képen megjelenik a felhasználói felület automációs fa vezérlő- és tartalomnézete, amely az adatrács és az osztott gombok vezérlőire vonatkozik. Az egyes automatizálási elemek vezérlőmintái zárójelben jelennek meg.

Felhasználói felület automatizálási fa – Vezérlőnézet Felhasználói felület automatizálási fa – Tartalomnézet
  • SplitButton "Name" (Meghívás, ExpandCollapse)
  • "További lehetőségek" gomb (meghívás)

    • Menü
    • Menüelem
  • SplitButton "Name" (Meghívás, ExpandCollapse)
  • "További lehetőségek" gomb (meghívás)

    • Menü
    • Menüelem

Lásd még