Role, proprietà

La proprietà Role descrive l'elemento dell'interfaccia utente di un oggetto. Tutti gli oggetti supportano la proprietà Role .

In molti casi, il ruolo dell'oggetto è ovvio. Ad esempio, le finestre hanno il ruolo ROLE_SYSTEM_WINDOW e i pulsanti push hanno il ruolo ROLE_SYSTEM_PUSHBUTTON .

La proprietà Role viene recuperata chiamando IAccessible::get_accRole.

Identificazione del ruolo di un oggetto

Microsoft Active Accessibility fornisce costanti dei ruoli, definite in oleacc.h, che identificano i ruoli oggetto comuni. È consigliabile che gli sviluppatori di server usino questi valori di ruolo predefiniti. Se viene restituita una costante del ruolo predefinita, i client usano la funzione GetRoleText per recuperare una stringa localizzata che descrive il ruolo.

Per i controlli di animazione, ad esempio il controllo animazione visualizzato durante la copia dei file, usare ROLE_SYSTEM_ANIMATION. Gli elementi grafici che vengono occasionalmente animati vengono descritti come ROLE_SYSTEM_GRAPHIC con la proprietà State impostata su STATE_SYSTEM_ANIMATED.

Si noti che alcuni ruoli non sono facili da descrivere. Ad esempio, la visualizzazione delle icone di grandi dimensioni di una cartella consente una disposizione arbitraria delle icone, in modo che il suo ruolo possa essere descritto come ROLE_SYSTEM_GROUPING. In alternativa, un controllo che fornisce elementi in righe e colonne fisse potrebbe avere il ruolo ROLE_SYSTEM_TABLE . Poiché un ruolo viene usato per comunicare il modello di utilizzo a un utente finale, è importante usare il ruolo appropriato. Ad esempio, se il controllo agisce come un pulsante, usare ROLE_SYSTEM_PUSHBUTTON.