Proprietà Description (funzionalità di accessibilità di Windows)

Nota

La proprietà Description viene spesso utilizzata in modo non corretto e non è supportata da Microsoft Automazione interfaccia utente. Gli sviluppatori del server Microsoft Active Accessibility non devono usare questa proprietà. Se sono necessarie altre informazioni per scenari di accessibilità e automazione, usare le proprietà supportate da Automazione interfaccia utente elementi e pattern di controllo.

 

La proprietà Description di un oggetto fornisce una descrizione testuale sull'aspetto visivo di un oggetto. La descrizione viene usata principalmente per fornire un contesto maggiore per gli utenti ipovedenti o ciechi, ma viene usata anche per la ricerca di contesto o altre applicazioni. Questa proprietà consente agli utenti di comprendere un'icona o l'aspetto visivo complessivo.

La proprietà Description viene recuperata chiamando IAccessible::get_accDescription.

Quando supportare la proprietà Description

I server supportano la proprietà Description se la descrizione non è ovvia o quando non è ridondante in base alle proprietà Name, Role, State e Value dell'oggetto. Ad esempio, un pulsante con etichetta "OK" non avrebbe bisogno di informazioni aggiuntive, mentre un pulsante che mostra un'immagine di un cactus sarebbe. Le proprietà Name, Role e Help per tale pulsante ne descrivono lo scopo, ma la proprietà Description fornisce informazioni meno tangibili; ad esempio, "Questo pulsante mostra un'immagine di un cactus".

Un server Microsoft Active Accessibility può aggiungere il supporto per Automazione interfaccia utente usando l'annotazione diretta, usando l'interfaccia IAccessibleEx o implementando Microsoft Active Accessibility e Automazione interfaccia utente side-by-side con entrambe le implementazioni che gestiscono il messaggio WM_GETOBJECT.

Uso dell'annotazione diretta

Interfaccia IAccessibleEx