Condividi tramite


Tipi di annotazione dinamica

In Microsoft Active Accessibility sono supportati tre tipi di annotazione dinamica: annotazione diretta, annotazione con mapping dei valorie annotazione server. Ogni tipo offre vantaggi specifici, quindi è importante comprendere le differenze.

Annotazione diretta

L'annotazione diretta è la forma più semplice di annotazione dinamica. È più applicabile per gli elementi accessibili la cui proprietà annotata non dipende dallo stato del controllo e non richiede il supporto aggiuntivo fornito dall'annotazione con mapping dei valori e dall'annotazione del server. L'annotazione diretta viene usata per eseguire l'override del valore di una o più proprietà di accessibilità Microsoft Active Accessibility di un elemento accessibile e per eseguire l'override o aggiungere una proprietà di Automazione interfaccia utente Microsoft al controllo. Tutte le annotazioni eseguite in una proprietà Microsoft Active Accessibility vengono riflesse nella traduzione dell'automazione interfaccia utente e nel proxy di Automazione interfaccia utente di Microsoft Active Accessibility-to-UI Automation. Per altre informazioni, vedere 'annotazione diretta.

Annotazione mappa valori

Oltre a aggiungere direttamente annotazioni proprietà IAccessible, spesso è necessario convertire un valore specifico del controllo in una stringa che può essere compresa da un utente finale. Un esempio è il controllo dispositivo di scorrimento per la risoluzione dello schermo nella scheda impostazioni della finestra Proprietà di visualizzazione (da Pannello di controllo). Mentre ogni posizione del dispositivo di scorrimento corrisponde a una risoluzione diversa (ad esempio, 640 x 480, 1024 x 768), il controllo non conosce questa relazione e non può trasmettere queste informazioni a Microsoft Active Accessibility.

L'annotazione con mapping dei valori semplifica questa attività. Usando questa forma di annotazione, è possibile specificare stringhe per i valori del dispositivo di scorrimento e specificare ruoli, stati e descrizioni per le icone nelle visualizzazioni elenco e albero. Per altre informazioni, vedere 'annotazione mappa valori.

Annotazione server

L'annotazione server consente agli sviluppatori di registrare un oggetto callback per le richieste client per la proprietà annotata di un elemento. Questo oggetto callback deve implementare l'interfacciaIAccPropServere essere registrata con i servizi di annotazione Microsoft Active Accessibility. Dopo la registrazione, verrà chiesto di gestire tutte le richieste client per il valore della proprietà dell'elemento accessibile.

Una funzionalità particolarmente utile dell'annotazione server è che un server può essere registrato una sola volta per gestire le richieste per un contenitore e tutti i relativi elementi figlio. Ad esempio, un singolo server può essere configurato una sola volta per gestire le richieste per tutti gli elementi è una casella di riepilogo. Per altre informazioni, vedere 'annotazione del server.