Değer Haritası Ek Açıklamasını Kullanma

değer eşlemesi oluşturmak için

1. Eşleme dizesi oluşturma.

   Eşleme dizesi, denetimin Unicode'da insan tarafından okunabilir bir dizeye karşılık gelen sayısal değerlerinin listesidir. "A:" ile başlar ve ardından kullanılan dizin türünü gösteren bir sayı gelir. Yalnızca görüntü dizinleri desteklenir; bu nedenle dizin türü her zaman 0 olur.

   Dizenin ardından :index:result çiftleri gelir. "Indeks", bir List-View veya Ağaç Görünümü (Tree-View) için görüntü indeksini ya da kaydırıcı denetiminin değerini temsil eden bir sayıdır.

   Sonuçta elde edilen değer, liste görünümü veya ağaç görünümü denetimi için Rol veya Durum özelliğini eşlediğinizde elde edilen bir sayıdır. Bu tür sayılar ondalık veya onaltılık olarak "0x" ön eki ile ifade edilir.

   Eşleme dizesi her zaman son iki nokta (":") ile sonlandırılır.

   Aşağıda, liste görünümünde veya ağaç görünümü denetiminde bir onay kutusunun Durum ve Rol özellikleri için bir açıklama haritası örneği verilmiştir. Görünümde onay kutularını temsil eden iki öğe vardır ve her birinde işaretli ve işaretsiz duruma karşılık gelen görüntüler bulunur.

   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":";
   

   Geçerli Rol ve Durum değerleri için bkz. Nesne Rolleri ve Nesne Durumu Sabitleri.

   Bir kaydırıcı denetiminin özelliklerini eşlerken dizin değeri negatif olabilir.

   Bir Value veya Description özelliğini eşlediğinizde sonuç bir dizedir. Dizgiler tırnak içine alınmaz ve iki nokta sınırlayıcı olarak görev yapar.

   Daha fazla bilgi için bkz. Açıklama Eşleme Biçimi.

2. Açıklama yöneticisini oluşturun veIAccPropServicesarabirimine bir işaretçi elde edin.

   Aşağıda ek açıklama yöneticisinin nasıl oluşturulduğuna ilişkin bir örnek verilmiştir.

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

3. Eşleme dizesini denetime ekleyin.

   IAccPropServices::SetHwndPropStrçağrısını yapın ve denetimin HWND ile eşleme dizesine bir işaretçi geçirin.

   IdProp parametresi aşağıdakilerden biri olacaktır.

   Parametre	İçin kullanılır
   MSAAPROPID_ROLEMAP	Liste görünümü veya ağaç görünümü denetimleri için rol eşlemesi ayarlamak için.
   MSAAPROPID_STATEMAP	Liste görünümü veya ağaç görünümü denetimleri için durum eşlemesi ayarlamak için.
   PROPID_ACC_DESCRIPTIONMAP	Liste görünümü veya ağaç görünümleri için bir açıklama haritası ayarlamak için.
   MSAAPROPID_VALUEMAP	Kaydırıcı kontrollerinde bir değer haritası ayarlamak için.

    

4. Temizlik yap.

   Ek açıklamalı değer eşleme denetimlerini yok etmeden önce (örneğin, WM_DESTROYişlenirken), önceden kaydedilmiş özellikleri temizlemeniz ve ek açıklama yöneticisini serbest bırakmanız gerekir.

   Bunu yapmak için, uygun şekilde IAccPropServices::ClearHwndProps çağırın ve işaretçinizi IAccPropServicesserbest bırakın.

Örnek kod için bkz. Değer Eşlemesi Ek Açıklama Örneği.