Värdemappningsanteckning

Med värdekartans anteckning kan du använda en mappningssträng för att ange hur bildindexet för ett objekt i en listvy eller trädvy motsvarar dess roll eller tillstånd. En mappningssträng kan till exempel indikera att en listvys bildindex 0 mappas till en roll i kryssrutan, medan bildindex 1 mappas till en roll som alternativknapp.

Du kan också använda värdekartan för att ange strängar som mappar till de numeriska värdena i ett skjutreglage.

När du ska använda den här tekniken

Överväg att använda värdekartans anteckning i följande situationer.

• När en ägarritad listvy eller trädvy innehåller användning av bilder och du vill ange en anpassad tillgänglig beskrivning (Beskrivning egenskap) baserat på den bilden. Följande bild visar ett exempel.

  

• När en ägarritad listvy eller trädvykontroll innehåller användning av bilder för att få träd- eller listobjekt att fungera som enkla kontroller, vanligtvis kryssrutor eller alternativknappar, och du vill mappa bilden till en roll. Följande skärmbild visar ett exempel.

  

• När ett skjutreglage används för att välja ett värde som kan beskrivas som något annat än ett enkelt heltal, som i följande skärmbild, där inställningen för skärmupplösning beskrivs av en sträng.

  

Med värdekartans anteckning anger en mappningssträng hur listans eller trädets bildindex motsvarar dess roll eller tillstånd. Eller så kan det indikera hur ett skjutreglages numeriska värde motsvarar en sträng. En mappningssträng kan till exempel indikera att en listvys bildindex 0 mappas till en roll i kryssrutan och bildindex 1 mappas till en roll som alternativknapp. Använd IAccPropServices::SetHwndPropStr() för att koppla mappningssträngen till kontrollen.

Eftersom kontrollspecifik kunskap krävs för att stödja värdemappning finns det ett begränsat antal kontroller och egenskaper som stöder värdekartans anteckningar, inklusive skjutreglagets värdekartor, listvyer och trädvyer.

Värdekarta för skjutreglage

PROPID_ACC_VALUEMAP innehåller en mappning från interna skjutreglagepositioner till läsbara strängar. Den här egenskapen stöds av Oleacc.dll skjutreglageproxy. Om det aktuella skjutreglagevärdet finns i värdekartan visas motsvarande sträng som värdet i stället för standardprocentsträngen (till exempel "50").

Listvy och trädvy

PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAPoch PROPID_ACC_DESCRIPTONMAP tillhandahålla mappningar från tillståndsbildindex till roll- och tillståndsvärden. Med dessa kartor kan dessa bildindex mappas till lämpliga roller (vanligtvis ROLE_SYSTEM_RADIOBUTTON eller ROLE_SYSTEM_CHECKBUTTON) och ytterligare tillståndsbitar (vanligtvis STATE_SYSTEM_CHECKED).

Mer information om värdekartans anteckningar finns i följande avsnitt:

• med hjälp av värdemappningsanteckning
• exempel på för värdekarta

Kartformat för anteckning

I följande tabell beskrivs de fält som ingår i en anteckningskarta.

Fält	Beskrivning
"A"	Anger att ett visst kodningsschema används. Ytterligare prefix kan stödjas för framtida kodningsscheman.
Avgränsartecken	Vanligtvis används ett kolon (:) används, men kan vara ett annat tecken förutom NULL- eller ett tomt utrymme. Eftersom det här tecknet används som avgränsare för de återstående fälten kanske det inte används som en del av ett värde i kartan.
0, 1 eller 2	Ett värde som anger vilken nyckel som används. För roll- och tillståndskartor för trädvy och listvy kan den här nyckeln vara 0 (bildindex), 1 (tillståndsbildindex) eller 2 (överläggsbildindex). För skjutreglage och andra kontroller som inte erbjuder ett val av nycklar måste det här värdet vara 0.
Avgränsartecken	:
Nyckelvärdepar	Varje par består av en nyckelsträng och ett avgränsartecken. Nyckelsträngen är ett tal och kan vara i decimal- eller hexadecimalt format (med ett inledande "0x"-prefix).
Värdesträng	För värdekartor är detta en sträng. För roll- och tillståndskartor är detta ett tal (decimal eller hexadecimal).
Avgränsartecken	:

 

En karta kan till exempel se ut så här:

A:0:0:Cold:1:Warm:3:Hot:

När den här värdekartan tillämpas på en skjutreglagekontroll visas värdet "Varm" när skjutreglaget är på plats 1. Eftersom värdet 2 inte ingår i det här exemplet exponeras standardvärdet för den positionen. För ett skjutreglage skulle standardvärdet vara ett procentvärde, till exempel 33.