Aantekening van waardetoewijzing

Met aantekening voor waardetoewijzing kunt u een toewijzingstekenreeks gebruiken om aan te geven hoe de afbeeldingsindex van een item in een lijstweergave of structuurweergave overeenkomt met de rol of status ervan. Een toewijzingstekenreeks kan bijvoorbeeld aangeven dat de afbeeldingsindex 0 van een lijstweergave wordt toegewezen aan een rol van selectievakje, terwijl afbeeldingsindex 1 is toegewezen aan een rol van keuzerondje.

U kunt ook een aantekening voor waardetoewijzing gebruiken om tekenreeksen op te geven die aan de numerieke waarden op een schuifregelaar worden toegewezen.

Wanneer gebruikt u deze techniek?

Overweeg in de volgende situaties waardetoewijzingaantekening te gebruiken.

• Wanneer een door de eigenaar getekende lijstweergave of boomstructuurweergave het gebruik van afbeeldingen bevat en u een aangepaste toegankelijke beschrijving (beschrijving eigenschap) wilt opgeven op basis van die afbeelding. In de volgende afbeelding ziet u een voorbeeld.

  

• Wanneer een door de eigenaar getekende lijstweergave of het besturingselement voor de structuurweergave het gebruik van afbeeldingen bevat om de boom- of lijstitems te laten fungeren als eenvoudige besturingselementen, meestal selectievakjes of keuzerondjes en u de afbeelding wilt toewijzen aan een rol. In de volgende schermafbeelding ziet u een voorbeeld.

  

• Wanneer een schuifregelaar wordt gebruikt om een waarde te selecteren die kan worden beschreven als iets anders dan een eenvoudig geheel getal, zoals in de volgende schermafbeelding, waarbij de instelling voor schermresolutie wordt beschreven door een tekenreeks.

  

Met aantekening voor waardetoewijzing geeft een toewijzingsreeks aan hoe de afbeeldingsindex van de lijst of boomstructuur overeenkomt met de rol of status van de lijst. U kunt ook aangeven hoe de numerieke waarde van een schuifregelaar overeenkomt met een tekenreeks. Een toewijzingstekenreeks kan bijvoorbeeld aangeven dat de afbeeldingsindex 0 van een lijstweergave wordt toegewezen aan een rol van selectievakje en afbeeldingsindex 1 wordt toegewezen aan een rol van keuzerondje. Gebruik IAccPropServices::SetHwndPropStr() om de toewijzingstekenreeks aan het besturingselement te koppelen.

Omdat controlespecifieke kennis vereist is om waardetoewijzing te ondersteunen, zijn er een beperkt aantal besturingselementen en eigenschappen die ondersteuning bieden voor waardetoewijzingsaantekening, waaronder schuifregelaarwaardekaarten, lijstweergaven en structuurweergaven.

Kaart met schuifregelaarwaarden

PROPID_ACC_VALUEMAP bevat een toewijzing van interne schuifregelaarposities naar door mensen leesbare tekenreeksen. Deze eigenschap wordt ondersteund door de Oleacc.dll schuifregelaarproxy. Als de huidige schuifregelaarwaarde in de waardetoewijzing wordt gevonden, wordt de bijbehorende tekenreeks weergegeven als de waarde in plaats van de standaardpercentagetekenreeks (bijvoorbeeld '50').

Lijstweergave en structuurweergave

PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAPen PROPID_ACC_DESCRIPTONMAP toewijzingen van statusafbeeldingsindexen aan rol- en statuswaarden bieden. Met deze kaarten kunnen die afbeeldingsindexen worden toegewezen aan de juiste rollen (meestal ROLE_SYSTEM_RADIOBUTTON of ROLE_SYSTEM_CHECKBUTTON) en extra status-bits (meestal STATE_SYSTEM_CHECKED).

Zie de volgende onderwerpen voor meer informatie over waardekaartaantekening:

• Een aantekening voor waardetoewijzing gebruiken
• voorbeeld van annotatie van waardetoewijzing

Indeling van aantekeningskaart

In de volgende tabel worden de velden beschreven die zijn opgenomen in een aantekeningskaart.

Veld	Beschrijving
'A'	Geeft aan dat een bepaald coderingsschema wordt gebruikt. Aanvullende voorvoegsels kunnen worden ondersteund voor toekomstige coderingsschema's.
Scheidingsteken	Meestal wordt een dubbele punt (:) gebruikt, maar kan een ander teken zijn, met uitzondering van NULL- of een lege spatie. Omdat dit teken wordt gebruikt als scheidingsteken voor de resterende velden, wordt dit mogelijk niet gebruikt als onderdeel van een waarde in de kaart.
0, 1 of 2	Een waarde die aangeeft welke sleutel wordt gebruikt. Voor rol- en statusoverzichten van structuurweergave en lijstweergave kan deze sleutel 0 (afbeeldingsindex), 1 (statusafbeeldingsindex) of 2 (overlay-afbeeldingsindex) zijn. Voor schuifregelaars en andere besturingselementen die geen keuze aan sleutels bieden, moet deze waarde 0 zijn.
Scheidingsteken	:
Sleutel-waardeparen	Elk paar bestaat uit een sleuteltekenreeks en een scheidingsteken. De sleuteltekenreeks is een getal en heeft mogelijk een decimale of hexadecimale notatie (met voorvoegsel 0x).
Waardetekenreeks	Voor waardetoewijzingen is dit een tekenreeks. Voor rol- en statustoewijzingen is dit een getal (decimaal of hexadecimaal).
Scheidingsteken	:

 

Een kaart kan er bijvoorbeeld als volgt uitzien:

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

Wanneer deze waardetoewijzing wordt toegepast op een schuifregelaar, wordt een waarde van 'Warm' weergegeven wanneer de schuifregelaar op positie 1 staat. Omdat waarde 2 niet is opgenomen in dit voorbeeld, wordt de standaardwaarde voor die positie weergegeven. Voor een schuifregelaar is de standaardwaarde een percentagewaarde, zoals 33.