Értéktérképi széljegyzet

Értékleképezési széljegyzetekkel egy leképezési sztringgel jelezheti, hogy egy listanézetben vagy fanézetben lévő elem képindexe hogyan felel meg a szerepkörének vagy állapotának. Egy leképezési sztring például azt jelezheti, hogy a listanézet 0 képindexe egy jelölőnégyzet szerepkörére van leképezve, míg az 1. képindex egy választógomb szerepkörére van leképezve.

Értéktérképi széljegyzetekkel is megadhat olyan sztringeket, amelyek a csúszkák numerikus értékeire képezhetők le.

Mikor érdemes használni ezt a technikát?

Az alábbi helyzetekben érdemes lehet értéktérkép-megjegyzést használni.

• Ha egy tulajdonos által rajzolt listanézet vagy fanézet magában foglalja a képek használatát, és a rendszerkép alapján egyéni, akadálymentes leírást (Leírás tulajdonságot) szeretne megadni. Az alábbi ábrán egy példa látható.

  

• Ha egy tulajdonos által rajzolt listanézet vagy fanézet vezérlőelem képek használatával teszi lehetővé, hogy a fa vagy listaelemek egyszerű vezérlőkként, általában jelölőnégyzetekhez vagy választógombokhoz hasonlóan működjenek, és a képet egy szerepkörre szeretné képezni. Az alábbi képernyőképen egy példa látható.

  

• Ha egy csúszkával olyan értéket választ ki, amely nem egyszerű egész számként írható le, mint az alábbi képernyőképen, ahol a képernyőfeloldási beállítást egy sztring írja le.

  beállításához használt csúszkáról

Értékleképezési széljegyzetek esetén a leképezési sztring azt jelzi, hogy a lista vagy a fa képindexe hogyan felel meg a szerepkörének vagy állapotának. Vagy azt is jelezheti, hogy egy csúszka numerikus értéke hogyan felel meg egy sztringnek. Egy leképezési sztring például azt jelezheti, hogy a listanézet képindexe 0 jelölőnégyzetre, a képindex 1 pedig egy választógomb szerepkörére van leképezve. A IAccPropServices::SetHwndPropStr() használatával csatolja a leképezési sztringet a vezérlőhöz.

Mivel az értékleképezés támogatásához vezérlőspecifikus ismeretekre van szükség, korlátozott számú vezérlő és tulajdonság támogatja az értéktérkép-széljegyzeteket, beleértve a csúszkaérték-leképezéseket, a listanézeteket és a fanézeteket.

Csúszka értéktérképe

PROPID_ACC_VALUEMAP tartalmaz egy leképezést a belső csúszkák pozícióiról az ember által olvasható sztringekre. Ezt a tulajdonságot a Oleacc.dll csúszkaproxy támogatja. Ha az aktuális csúszka értéke megtalálható az értéktérképen, a megfelelő sztring az alapértelmezett százalékos sztring helyett értékként jelenik meg (például "50").

Listanézet és fanézet

PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAPés PROPID_ACC_DESCRIPTONMAP biztosít leképezéseket az állapotképindexektől a szerepkör- és állapotértékekig. Ezek a térképek lehetővé teszik, hogy ezek a képindexek megfelelő szerepkörökhöz (általában ROLE_SYSTEM_RADIOBUTTON vagy ROLE_SYSTEM_CHECKBUTTON) és további állapotbitekhez (általában STATE_SYSTEM_CHECKED) legyenek leképezve.

Az értéktérkép széljegyzetével kapcsolatos további információkért tekintse meg az alábbi témaköröket:

• Értéktérkép-széljegyzet
• értéktérkép-jegyzetminta

Széljegyzettérkép formátuma

Az alábbi táblázat a széljegyzettérképben szereplő mezőket ismerteti.

Mező	Leírás
"A"	Azt jelzi, hogy egy adott kódolási séma van használatban. A jövőbeli kódolási sémák esetében további előtagok is támogatottak lehetnek.
Elválasztó karakter	Általában kettőspontot (:) használ, de NULL vagy üres szóköz kivételével más karakter is lehet. Mivel ez a karakter elválasztóként lesz használva a többi mezőhöz, előfordulhat, hogy a program nem használja a térkép egyik értékének részeként.
0, 1 vagy 2	Egy érték, amely azt jelzi, hogy melyik kulcsot használja a rendszer. Fanézeti és listanézeti szerepkörök és állapottérképek esetén ez a kulcs lehet 0 (képindex), 1 (állapotképindex) vagy 2 (átfedési képindex). Az olyan csúszkák és egyéb vezérlők esetében, amelyek nem kínálnak választható kulcsokat, ennek az értéknek 0-nak kell lennie.
Elválasztó karakter	:
Kulcsértékpárok	Minden pár egy kulcssztringből és egy elválasztó karakterből áll. A kulcssztring egy szám, és lehet decimális vagy hexadecimális (kezdő "0x" előtaggal) formátumban.
Értéksztring	Értéktérképek esetén ez egy sztring. A szerepkör- és állapottérképek esetében ez egy szám (decimális vagy hexadecimális).
Elválasztó karakter	:

 

Egy térkép például a következőhöz hasonlóan nézhet ki:

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

Ha ezt az értéktérképet egy csúszka vezérlőelemre alkalmazza, a csúszka 1. pozíciójában a "Meleg" érték jelenik meg. Mivel a példában nem szerepel a 2. érték, az adott pozíció alapértelmezett értéke lesz közzétéve. Csúszkák esetén az alapértelmezett érték százalékérték, például 33.