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

Felhasználói felület automatizálási tulajdonságainak áttekintése

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.

A felhasználói felületi automatizálási szolgáltatók tulajdonságokat fednek fel a Microsoft UI Automation-elemeken. Ezek a tulajdonságok lehetővé teszik a felhasználói felület automation-ügyfélalkalmazásainak a felhasználói felület (UI) egyes részeire vonatkozó információk felderítését, különösen a vezérlőket, beleértve a statikus és a dinamikus adatokat is.

Ez a szakasz átfogó áttekintést nyújt a Microsoft UI Automation tulajdonságairól. További információt a következő témakörökben talál:

Tulajdonságazonosítók

Minden tulajdonságot egy szám és egy név azonosít. A tulajdonságok nevei csak a hibakereséshez és a diagnosztizáláshoz használhatók. A szolgáltatók a numerikus azonosítókkal azonosítják a bejövő tulajdonságkéréseket. Az ügyfélalkalmazások azonban csak a AutomationProperty, amely a számot és a nevet foglalja magába, használják a beolvasni kívánt tulajdonságok azonosításához.

AutomationProperty az adott tulajdonságokat képviselő objektumok különböző osztályok mezőiként érhetők el. Biztonsági okokból a felhasználói felület automatizálási szolgáltatói ezeket az objektumokat egy különálló osztálykészletből szerzik be, amely a Uiautomationtypes.dll-ban található.

Az alábbi táblázat kategorizálja a tulajdonságokat az AutomationPropertyazonosítókat tartalmazó osztályok szerint.

Tulajdonságok típusai Az ügyfelek azonosítókat kapnak a [forrásból] A szolgáltatók azonosítókat kapnak a
Az összes elem közös tulajdonságai (lásd a következő táblázatokat) AutomationElement AutomationElementIdentifiers
Dokkoló ablak elhelyezése DockPattern DockPatternIdentifiers
Kibontható és összecsukható elem állapota ExpandCollapsePattern ExpandCollapsePatternIdentifiers
Egy elem tulajdonságai egy rácsban GridItemPattern GridItemPatternIdentifiers
Rács tulajdonságai GridPattern GridPatternIdentifiers
Több nézetet tartalmazó elem aktuális és támogatott nézete MultipleViewPattern MultipleViewPatternIdentifiers
Egy értéktartományon (például csúszkán) átmozduló elem tulajdonságai RangeValuePattern RangeValuePatternIdentifiers
Görgetőablak tulajdonságai ScrollPattern ScrollPatternIdentifiers
Egy elem kijelölhető állapota és tárolója, mint egy listában SelectionItemPattern SelectionItemPatternIdentifiers
Kijelölési elemeket tartalmazó vezérlőelem tulajdonságai SelectionPattern SelectionPatternIdentifiers
Egy tábla egy elemének oszlop- és sorfejlécei TableItemPattern TableItemPatternIdentifiers
Táblázat oszlop- és sorfejlécei, tájolása TablePattern TablePatternIdentifiers
A kapcsolóvezérlő állapota TogglePattern TogglePatternIdentifiers
Az áthelyezhető, elforgatható vagy átméretezhető elemek képességei TransformPattern TransformPatternIdentifiers
Egy értékkel rendelkező elem értéke és olvasási/írási képességei ValuePattern ValuePatternIdentifiers
Az ablak képességei és állapota WindowPattern WindowPatternIdentifiers

Tulajdonságok kategória szerint

Az alábbi táblázatok kategorizálják azokat a tulajdonságokat, amelyek azonosítói megtalálhatók a AutomationElement és AutomationElementIdentifiers-ben. Ezek a tulajdonságok minden vezérlőre jellemzőek. A szolgáltatói alkalmazás élettartama során valószínűleg csak néhány kivétel marad statikus; a legtöbb dinamikus tulajdonság a vezérlőmintákkal van társítva.

A Tulajdonsághozzáférés oszlop az egyes tulajdonságokhoz tartozó további hozzáférési eszközöket sorolja fel, a GetCurrentPropertyValue és GetCachedPropertyValue kivételeken túl. További információ az ügyfélalkalmazások tulajdonságainak lekéréséről: UI Automation Properties for Clients.

Megjegyzés:

Az egyes tulajdonságokkal kapcsolatos konkrét információkért kövesse a Tulajdonsághozzáférés oszlopban található hivatkozást.

Megjelenítési jellemzők

Tulajdonságazonosító Tulajdonsághozzáférés
BoundingRectangleProperty BoundingRectangle
CultureProperty nincs adat
HelpTextProperty HelpText
IsOffscreenProperty IsOffscreen
OrientationProperty Orientation

Elem típusa

Tulajdonságazonosító Tulajdonsághozzáférés
ControlTypeProperty ControlType
IsContentElementProperty IsContentElement
IsControlElementProperty IsControlElement
ItemTypeProperty ItemType
LocalizedControlTypeProperty LocalizedControlType

Azonosítás

Tulajdonságazonosító Tulajdonsághozzáférés
AutomationIdProperty AutomationId
ClassNameProperty ClassName
FrameworkIdProperty FrameworkId
LabeledByProperty LabeledBy
NameProperty Name
ProcessIdProperty ProcessId
RuntimeIdProperty GetRuntimeId
NativeWindowHandleProperty NativeWindowHandle

Kölcsönhatás

Tulajdonságazonosító Tulajdonsághozzáférés
AcceleratorKeyProperty AcceleratorKey
AccessKeyProperty AccessKey
ClickablePointProperty GetClickablePoint
HasKeyboardFocusProperty HasKeyboardFocus
IsEnabledProperty IsEnabled
IsKeyboardFocusableProperty IsKeyboardFocusable

Minták támogatása

Tulajdonságazonosító Tulajdonsághozzáférés
IsDockPatternAvailableProperty GetSupportedPatterns
IsExpandCollapsePatternAvailableProperty GetSupportedPatterns
IsGridItemPatternAvailableProperty GetSupportedPatterns
IsGridPatternAvailableProperty GetSupportedPatterns
IsInvokePatternAvailableProperty GetSupportedPatterns
IsMultipleViewPatternAvailableProperty GetSupportedPatterns
IsRangeValuePatternAvailableProperty GetSupportedPatterns
IsScrollItemPatternAvailableProperty GetSupportedPatterns
IsScrollPatternAvailableProperty GetSupportedPatterns
IsSelectionItemPatternAvailableProperty GetSupportedPatterns
IsSelectionPatternAvailableProperty GetSupportedPatterns
IsTableItemPatternAvailableProperty GetSupportedPatterns
IsTablePatternAvailableProperty GetSupportedPatterns
IsTextPatternAvailableProperty GetSupportedPatterns
IsTogglePatternAvailableProperty GetSupportedPatterns
IsTransformPatternAvailableProperty GetSupportedPatterns
IsValuePatternAvailableProperty GetSupportedPatterns
IsWindowPatternAvailableProperty GetSupportedPatterns

Egyéb

Tulajdonságazonosító Tulajdonsághozzáférés
IsRequiredForFormProperty IsRequiredForForm
IsPasswordProperty IsPassword
ItemStatusProperty ItemStatus

Lokalizáció

A felhasználói felületi automatizálási szolgáltatóknak az alábbi tulajdonságokat kell bemutatniuk az operációs rendszer nyelvén:

Tulajdonságok és események

A felhasználói felület automatizálásának tulajdonságaival szorosan összefügg a tulajdonságváltozású események fogalma. A dinamikus tulajdonságok esetében az ügyfélalkalmazásnak tudnia kell, hogy egy tulajdonság értéke megváltozott, hogy frissíthesse az információgyorsítótárat, vagy más módon reagáljon az új információkra.

A szolgáltatók eseményeket váltanak ki, amikor a felhasználói felületen valami megváltozik. Ha például egy jelölőnégyzet ki van jelölve vagy törölve van, a tulajdonságot módosító eseményt a kapcsolóminta szolgáltató általi megvalósítása aktiválja. A szolgáltatók szelektíven állíthatnak elő eseményeket attól függően, hogy az ügyfelek figyelik-e az eseményeket, vagy adott eseményeket figyelnek.

Nem minden tulajdonságmódosítás előz meg eseményeket; ez teljes mértékben az elem felhasználói felületi automatizálási szolgáltatójának megvalósításán múlik. A listamezők szabványos proxyszolgáltatói például nem aktiválnak eseményt a SelectionProperty módosításokkor. Ebben az esetben az alkalmazásnak inkább figyelnie kell egy ElementSelectedEvent.

Az ügyfelek a feliratkozásukkal figyelik az eseményeket. Az eseményekre való feliratkozás azt jelenti, hogy delegált metódusokat hoz létre, amelyek képesek kezelni az eseményeket, majd átadják a metódusokat a felhasználói felület automatizálásának, valamint az ezekben a metódusokban kezelendő konkrét eseményeknek. A tulajdonság-módosító események esetén az ügyfeleknek implementálniuk kell AutomationPropertyChangedEventHandler.

Lásd még

  • Last updated on