Typer av dynamisk anteckning

Det finns tre typer av dynamisk anteckning som stöds i Microsoft Active Accessibility: direkt anteckning, värdemappad anteckningoch serveranteckning. Varje typ erbjuder specifika fördelar, så det är viktigt att förstå skillnaderna.

Direktanteckning

Direktanteckning är den enklaste formen av dynamisk anteckning. Det är mest tillämpligt för tillgängliga element vars kommenterade egenskap inte är beroende av kontrollens tillstånd och inte kräver ytterligare stöd som tillhandahålls av värdemappad anteckning och serveranteckning. Direktkommentar används för att åsidosätta värdet för en eller flera Microsoft Active Accessibility-egenskaper för ett tillgängligt element och för att åsidosätta eller lägga till en Microsoft UI Automation-egenskap i kontrollen. Alla anteckningar som görs i en Microsoft Active Accessibility-egenskap återspeglas i UI Automation-översättningen samt i Microsoft Active Accessibility-to-UI Automation-proxyn. Mer information finns i Direct Annotation.

Värdemappningsanteckning

Förutom att direkt kommentera IAccessible egenskaper, finns det ofta ett behov av att konvertera ett kontrollspecifikt värde till en sträng som kan förstås av en slutanvändare. Ett exempel är skjutreglaget för skärmupplösning under fliken Inställningar i fönstret Visningsegenskaper (från Kontrollpanelen). Varje skjutreglageposition motsvarar en annan upplösning (till exempel 640 x 480, 1 024 x 768), men kontrollen har ingen kunskap om den här relationen och kan inte förmedla den här informationen till Microsoft Active Accessibility.

Värdemappad anteckning gör den här uppgiften enklare. Med den här typen av anteckning kan du ange strängar för skjutreglagevärden och ange roller, tillstånd och beskrivningar för ikoner i list- och trädvyer. Mer information finns i värdemappningsanteckning.

Serveranteckning

Med serveranteckning kan utvecklare registrera ett motringningsobjekt för att hantera klientbegäranden för ett elements kommenterade egenskap. Det här motringningsobjektet måste implementera gränssnittet IAccPropServer och registreras med Microsoft Active Accessibility-anteckningstjänster. När den har registrerats uppmanas den att hantera alla klientbegäranden för det tillgängliga elementets egenskapsvärde.

En särskilt användbar funktion i serveranteckningen är att en server kan registreras en gång för att hantera begäranden för en container och alla dess underordnade. En enskild server kan till exempel konfigureras en gång för att hantera begäranden för alla objekt är en listruta. Mer information finns i ServerAnnotation.