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 di pressione 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 di ruolo , definite in oleacc.h, che identificano i ruoli di oggetto comuni. È consigliabile che gli sviluppatori di server usino questi valori predefiniti del ruolo. Se viene restituita una costante del ruolo predefinita, i client usano la funzioneGetRoleTextper 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. La grafica a volte animata viene descritta come ROLE_SYSTEM_GRAPHIC con la proprietàstateimpostata 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, quindi il suo ruolo può 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.