Pattern di controllo di automazione interfaccia utente per i client
.gif "Nota") Nota |
|---|
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese). |
In questo argomento viene presentata un'introduzione ai pattern di controllo per i client di automazione interfaccia utente. Sono incluse informazioni sulla modalità di utilizzo dei pattern di controllo da parte di un client di automazione interfaccia utente per accedere a informazioni relative all'user interface (UI).
I pattern di controllo consentono di suddividere in categorie ed esporre le funzionalità di un controllo indipendentemente dal tipo o dall'aspetto del controllo stesso. I client di automazione interfaccia utente possono esaminare un oggetto AutomationElement per determinare quali pattern di controllo sono supportati e verificare il comportamento del controllo.
Per un elenco completo di pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.
Nel presente argomento sono contenute le seguenti sezioni.
- Recupero dei pattern di controllo
- Recupero delle proprietà sui pattern di controllo
- Controlli con pattern variabili
- Argomenti correlati
Recupero dei pattern di controllo
I client recuperano un pattern di controllo da un oggetto AutomationElement chiamando il metodo AutomationElement.GetCachedPattern o il metodo AutomationElement.GetCurrentPattern.
I client possono utilizzare il metodo GetSupportedPatterns o una singola proprietà IsPatternAvailable (ad esempio, IsTextPatternAvailableProperty) per determinare se un pattern o un gruppo di pattern è supportato nell'oggetto AutomationElement. È tuttavia più efficace tentare di ottenere il pattern di controllo ed eseguire il test per cercare un riferimento null che controllare le proprietà supportate e recuperare il pattern di controllo, poiché questa operazione comporta un numero inferiore di chiamate tra processi.
Nell'esempio riportato di seguito viene illustrato come ottenere un pattern di controllo TextPattern da un oggetto AutomationElement.
// 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;
}
Recupero delle proprietà sui pattern di controllo
I client possono recuperare i valori delle proprietà nei pattern di controllo chiamando il metodo AutomationElement.GetCachedPropertyValue o AutomationElement.GetCurrentPropertyValue ed eseguendo il cast dell'oggetto restituito a un tipo appropriato. Per ulteriori informazioni sulle proprietà di UI Automation, vedere Proprietà di automazione interfaccia utente per i client.
Oltre ai metodi GetPropertyValue, i valori delle proprietà possono essere recuperati tramite le funzioni di accesso di common language runtime (CLR) per accedere alle proprietà di UI Automation in un pattern.
Controlli con pattern variabili
Alcuni tipi di controllo supportano pattern diversi in base allo stato o alla modalità di utilizzo del controllo. Gli esempi di controlli con pattern variabili sono visualizzazioni elenco (miniature, elementi affiancati, icone, elenco, dettagli), grafici di Microsoft Excel (a torta, a linee, a barre, valore della cella con formula), area dei documenti di Microsoft Word (normale, layout Web, struttura, layout di stampa, anteprima di stampa) e interfacce di Microsoft Windows Media Player.
I controlli che implementano tipi di controllo personalizzati possono avere qualsiasi insieme di pattern di controllo necessario a rappresentarne la funzionalità.
Vedere anche
Attività
Richiamare un controllo utilizzando automazione interfaccia utente
ValuePattern Insert Text Sample
TextPattern Search and Selection Sample
InvokePattern, ExpandCollapsePattern, and TogglePattern Sample
Concetti
Mapping dei pattern di controllo per i client di automazione interfaccia utente