Recupero di proprietà da elementi Automazione interfaccia utente

  • Articolo

Le proprietà sugli oggetti IUIAutomationElement contengono informazioni sugli elementi dell'interfaccia utente, in genere controlli. Le proprietà di un elemento sono generiche; ovvero, non specifico di un tipo di controllo. Le proprietà specifiche del controllo di un elemento vengono esposte dalle interfacce del pattern di controllo.

Le proprietà di Microsoft Automazione interfaccia utente sono di sola lettura. Per impostare le proprietà di un controllo, è necessario usare i metodi del pattern di controllo appropriato. Ad esempio, usare IUIAutomationScrollPattern::Scroll per modificare i valori di posizione di una finestra di scorrimento.

Per migliorare le prestazioni, i valori delle proprietà dei controlli e dei pattern di controllo possono essere memorizzati nella cache quando vengono recuperati gli elementi. Per altre informazioni, vedere Memorizzazione nella cache Automazione interfaccia utente proprietà e pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

ID di proprietà

Gli identificatori di proprietà sono definiti in Uiautomationclient.h. Vengono usati per specificare le proprietà quando si sottoscrivono eventi di modifica delle proprietà, recuperano i valori delle proprietà e costruiscono le condizioni delle proprietà. Gli identificatori di proprietà identificano anche la proprietà modificata quando viene chiamato IUIAutomationPropertyChangedEventHandler::HandlePropertyChangedEvent .

Per un elenco di identificatori di proprietà Automazione interfaccia utente, vedere Identificatori di proprietà.

Condizioni della proprietà

Gli ID di proprietà vengono usati per costruire oggetti IUIAutomationPropertyCondition usati per trovare Automazione interfaccia utente elementi. Ad esempio, è possibile trovare un elemento con un determinato nome o tutti i controlli abilitati. Ogni condizione di proprietà specifica un identificatore di proprietà e il valore che la proprietà deve corrispondere.

Per altre informazioni, vedere gli argomenti di riferimento riportati di seguito:

Recupero di proprietà

Alcune proprietà generiche e tutte le proprietà del pattern di controllo sono disponibili come proprietà nell'interfaccia IUIAutomationElement o pattern di controllo e possono essere recuperate tramite una funzione di accesso, ad esempio IUIAutomationElement::CurrentName o CachedDockPosition.

Inoltre, qualsiasi proprietà corrente o memorizzata nella cache (diversa dalle proprietà del pattern di controllo) può essere recuperata usando uno dei metodi seguenti:

Questi metodi offrono prestazioni leggermente migliori e l'accesso all'intera gamma di proprietà. Tuttavia, i valori vengono restituiti nelle strutture VARIANT , mentre le singole funzioni di accesso alle proprietà eseguono il cast del valore al tipo appropriato.

Valori di proprietà predefiniti

Se un provider di Automazione interfaccia utente non implementa una proprietà, Automazione interfaccia utente può fornire un valore predefinito. Ad esempio, se il provider di un controllo non supporta la proprietà identificata da UIA_HelpTextPropertyId, Automazione interfaccia utente restituisce una stringa vuota. Analogamente, se il provider non supporta la proprietà identificata da UIA_IsDockPatternAvailablePropertyId, Automazione interfaccia utente restituisce FALSE.

La differenza tra IUIAutomationElement::GetCurrentPropertyValue e GetCurrentPropertyValueEx (e tra coppie simili di metodi) è che il metodo "Ex" può specificare che non deve essere restituito alcun valore predefinito. In questo caso, il valore restituito è una costante univoca speciale che indica che la proprietà non è supportata. Quando si riceve questo valore, l'applicazione può fornire il proprio valore o semplicemente ignorare la proprietà .

Informazioni concettuali

Cenni preliminari sulle proprietà di automazione interfaccia utente

Identificatori di proprietà