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

Felhasználói felület automatizálásának vezérlési mintái ügyfelek számára

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 az áttekintés a felhasználói felületi automatizálási ügyfelek vezérlési mintáit mutatja be. Információkat tartalmaz arról, hogy egy UI Automation-ügyfél hogyan használhat vezérlési mintákat a felhasználói felület (UI) információinak eléréséhez.

A vezérlőminták lehetővé teszik, hogy kategorizálják és elérhetővé tegyék a vezérlő funkcióit a vezérlő típusától vagy megjelenésétől függetlenül. A felhasználói felület-automatizálási ügyfelek megvizsgálhatnak egy olyan AutomationElement vizsgálatot, amely meghatározza, hogy mely vezérlőminták támogatottak, és meggyőződhetnek a vezérlő viselkedéséről.

A vezérlési minták teljes listájáért tekintse meg a felhasználói felület automatizálásának vezérlési mintáinak áttekintését.

Szabályozási minták lekérése

Az ügyfelek vezérlő mintát lekérnek egy AutomationElement-ból, akár AutomationElement.GetCachedPattern vagy AutomationElement.GetCurrentPattern hívásával.

Az ügyfelek a GetSupportedPatterns metódussal vagy egy egyéni IsPatternAvailable tulajdonsággal (például IsTextPatternAvailableProperty) megállapíthatják, hogy támogatott-e egy minta vagy mintacsoport a AutomationElement. Hatékonyabb azonban a vezérlőminta lekérése és a null referencia tesztelése, mint a támogatott tulajdonságok ellenőrzése és a vezérlőminta lekérése, mivel kevesebb folyamatközi hívást eredményez.

Az alábbi példa bemutatja, hogyan kérhet le egy TextPattern vezérlőmintát AutomationElement-ból.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Tulajdonságok lekérése vezérlőmintákon

Az ügyfelek a vezérlőminták tulajdonságértékeit úgy kérhetik le, hogy meghívják vagy a AutomationElement.GetCachedPropertyValue és a AutomationElement.GetCurrentPropertyValue metódusokat, majd a visszaadott objektumot átkonvertálják megfelelő típusúra. További információ a felhasználói felület automatizálási tulajdonságairól: UI Automation Properties for Clients.

A metódusok mellett a tulajdonságértékek a közös nyelvi futtatókörnyezet (CLR) hozzáférési eszközein keresztül is lekérhetők, hogy hozzáférjenek a felhasználói felület automatizálás tulajdonságaihoz egy mintán.

Változó mintákkal rendelkező vezérlők

Egyes vezérlőtípusok az állapotuktól vagy a vezérlőelem használatának módjától függően különböző mintákat támogatnak. A változó mintákkal rendelkező vezérlők például listanézetek (miniatűrök, csempék, ikonok, lista, részletek), Microsoft Excel-diagramok (kör, vonal, sáv, cellaérték képlettel), a Microsoft Word dokumentumterülete (Normál, Webes elrendezés, Vázlat, Nyomtatási elrendezés, Nyomtatási kép) és Microsoft Windows Media Player-bőrök.

Az egyéni vezérlőtípusokat megvalósító vezérlők bármilyen szabályozási mintával rendelkezhetnek, amelyek a funkciójuk megjelenítéséhez szükségesek.

Lásd még

  • Last updated on