Použití poznámek k mapě hodnot

Vytvoření mapy hodnot

  1. Vytvoření řetězce mapování

    Mapovací řetězec je seznam číselných hodnot ovládacího prvku odpovídající čitelnému řetězci v kódu Unicode. Začíná řetězcem "A:", za kterým následuje číslo, které označuje typ použitého indexu. Podporují se pouze indexy obrázků; proto je typ indexu vždy 0.

    Za řetězcem následují páry :index:výsledek. Index je číslo představující index obrázku pro List-View nebo stromové zobrazení nebo hodnotu ovládacího prvku posuvníku.

    Výsledná hodnota je číslo získané při mapování vlastnosti Role nebo Stav pro ovládací prvek typu seznamu nebo stromového zobrazení. Tato čísla jsou vyjádřena desetinnou nebo šestnáctkovou předponou "0x".

    Řetězec mapování se vždy ukončí poslední dvojtečkou (":").

    Následuje příklad mapy poznámek pro vlastnosti státu a role zaškrtávacího políčka v zobrazení seznamu nebo ovládacím prvku stromového zobrazení. V zobrazení jsou dvě položky, které představují zaškrtávací políčka, a každý z nich má obrázky odpovídající zaškrtnutému a nezaškrtnutému stavu.

    LPCWSTR g_ListOrTreeStateMap = 
L"A:0"     // Index type; always 0. !
L":0:0x00" // Image 0 is normal !
L":1:0x10" // Image 1 is checked - STATE_SYSTEM_CHECKED (0x10) !
L":";

LPCWSTR g_ListOrTreeRoleMap = 
L"A:0"     // Index type; always 0. !
L":0:0x2C" // Image 0 is a check box - ROLE_SYSTEM_CHECKBUTTON
(0x2c) !
L":1:0x2C" // image 1 is also a check box !
L":";

    Platné hodnoty role a stavu najdete v tématu Role objektu a konstanty stavu objektu .

    Hodnota indexu může být záporná při mapování vlastností pro ovládací prvek posuvníku.

    Při mapování vlastnosti Hodnota nebo Popis je výsledkem řetězec. Řetězce nejsou uvozovány a dvojtečky fungují jako oddělovače.

    Další informace naleznete v formát mapy poznámek.

  2. Vytvořit správce poznámek a získat ukazatel na jehoIAccPropServicesrozhraní.

    Následuje příklad vytvoření správce poznámek.

    IAccPropServices * pAccPropSvc = NULL;
HRESULT hr = CoCreateInstance(CLSID_AccPropServices, NULL,
CLSCTX_SERVER, IID_IAccPropServices, (void**) & pAccPropSvc));

  3. Připojte k ovládacímu prvku řetězec mapování.

    Volání IAccPropServices::SetHwndPropStr, s předáním HWND ovládacího prvku a ukazatele na mapovací řetězec.

    Parametr IdProp bude jedním z následujících.

    Parametr Používá se pro
    MSAAPROPID_ROLEMAP Nastavení mapy rolí pro zobrazení seznamu nebo ovládací prvky stromového zobrazení
    MSAAPROPID_STATEMAP Nastavení mapy stavu pro ovládací prvky zobrazení seznamu nebo stromového zobrazení
    PROPID_ACC_DESCRIPTIONMAP Nastavit mapu popisů pro zobrazení seznamu nebo stromového zobrazení.
    MSAAPROPID_VALUEMAP Nastavení mapy hodnot na ovládacích prvcích posuvníku

     

  4. Vyčistit.

    Před zničením anotovaných ovládacích prvků mapy hodnot (například při zpracování WM_DESTROY) musíte vymazat dříve registrované vlastnosti a uvolnit správce anotací.

    Chcete-li to provést, zavolejte IAccPropServices::ClearHwndProps podle potřeby a uvolněte ukazatel na IAccPropServices.

Vzorový kód najdete v ukázkové anotaci mapy hodnot .

 

 

  • Last updated on