Tipi di annotazione dinamica
In Microsoft Active Accessibility sono supportati tre tipi di annotazione dinamica: annotazione diretta, annotazione con mapping dei valori e 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 agli elementi accessibili la cui proprietà annotata non dipende dallo stato del controllo e non richiede il supporto aggiuntivo fornito dall'annotazione mappata con valori e dall'annotazione del server. L'annotazione diretta viene usata per eseguire l'override del valore di una o più proprietà di Microsoft Active Accessibility di un elemento accessibile e per eseguire l'override o aggiungere una proprietà microsoft Automazione interfaccia utente al controllo. Tutte le annotazioni effettuate in una proprietà Microsoft Active Accessibility vengono riflesse nella traduzione Automazione interfaccia utente e nel proxy da Microsoft Active Accessibility a Automazione interfaccia utente. Per altre informazioni, vedere Annotazione diretta.
Annotazione mappa valori
Oltre a annotare direttamente le 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à 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 mappata a 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 di callback per gestire le richieste client per la proprietà annotata di un elemento. Questo oggetto callback deve implementare l'interfaccia IAccPropServer e essere registrato con i servizi di annotazione di Microsoft Active Accessibility. Dopo la registrazione, verrà richiesto di gestire tutte le richieste client per il valore della proprietà dell'elemento accessibile.
Una funzionalità particolarmente utile dell'annotazione del 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 server.