Kiszolgálói annotáció használata

Ez a témakör a visszahívási objektum megadásához kiszolgálói széljegyzetek használatával kapcsolatos információkat tartalmaz.

Visszahívási objektumot meghatározó tulajdonság felülbírálása

1. Szerezzen be egy IAccessible interfészmutatót a megjegyzésként kezelendő akadálymentes elemhez.
2. Hívja meg a QueryInterface az akadálymentes elemen, hogy megkapja a IAccIdentity interfészmutatóját.
3. Hívja meg a IAccIdentity felület mutatóján a IAccIdentity::GetIdentityString() függvényt, hogy megszerezzen egy karakterláncot, amely egyedileg azonosítja a jegyzetelendő akadálymentes elemet.
4. A IAccPropServices objektum létrehozásához használja CoCreateInstance vagy CoCreateInstanceEx.
5. Hozzon létre egy COM-objektumot, amely implementálja IAccPropServer.
6. Hívja meg a IAccPropServices::SetPropServerfüggvényt, átadva az identitássztringet, a felülbírálandó tulajdonságot jelző GUID-t, valamint egy mutatót az IAccPropServer visszahívási objektumra.
7. Szabadítsa fel az interfészmutatókat és törölje a memóriát.

Amikor egy ügyfél az akadálymentes elem tulajdonságát kéri, a rendszer meghívja a visszahívási objektumot, és visszaadja az értéket az ügyfélnek.

Az érték megadásához hasonlóan a kiszolgálófejlesztők is használhatják az IAccPropServices::ComposeHwndIdentityString metódust egy identitássztring beszerzéséhez; vagy használhatják a IAccPropServices::SetHwndPropServer metódust, és identitássztring helyett megadják a hwnd, idObjectvagy idChild paramétereket.

Amikor a SetPropServer vagy a SetHwndPropServer metódusokat használják egy tárolóobjektumon, a kiszolgálófejlesztők opcionálisan megadhatják, hogy a felülíró információk alkalmazandók legyenek a tároló összes elemgyermekére is.

A kiszolgálók az IAccPropServices::ClearProps használatával bármikor explicit módon törölhetik a széljegyzeteket. Erre általában nincs szükség, mivel a széljegyzetszolgáltatás automatikusan törli és felszabadítja a széljegyzetadatokat, amikor a jegyzetelt akadálymentes elem eltűnik.

Az alábbiakban felsoroljuk azokat a tulajdonságokat, amelyek az eljárással jegyzetelhetők.

A visszahívások megadásakor támogatott tulajdonságok

Visszahívás megadásakor a következő tulajdonságok jegyzetelhetők. Ezek a tulajdonságok jelenleg nem jegyzetelhetők közvetlenül egy érték megadásával.

Ingatlan	Típus
PROPID_ACC_NAME	VT_BSTR
PROPID_ACC_LEÍRÁS	VT_BSTR
PROPID_ACC_ROLE	VT_I4
PROPID_ACC_STATE	VT_I4
PROPID_ACC_SEGÍTSÉG	VT_BSTR
PROPID_ACC_KEYBOARDSHORTCUT	VT_BSTR
PROPID_ACC_DEFAULTACTION	VT_BSTR
PROPID_ACC_VALUEMAP	VT_BSTR
PROPID_ACC_ROLEMAP	VT_BSTR
PROPID_ACC_STATEMAP	VT_BSTR
PROPID_ACC_FOCUS	VT_DISPATCH VT_I4
PROPID_ACC_SELECTION	VT_DISPATCH VT_I4 VT_UNKNOWN
PROPID_ACC_PARENT	VT_DISPATCH (nem fordított, technikai kifejezés)
PROPID_ACC_NAV_UP	VT_DISPATCH VT_I4
PROPID_ACC_NAV_DOWN	VT_DISPATCH VT_I4
PROPID_ACC_NAV_LEFT	VT_DISPATCH VT_I4
PROPID_ACC_NAV_RIGHT	VT_DISPATCH VT_I4
Előző navigációs lépés	VT_DISPATCH VT_I4
PROPID_ACC_NAV_NEXT	VT_DISPATCH VT_I4
PROPID_ACC_NAV_FIRSTCHILD (első gyermek navigációs azonosító)	VT_DISPATCH VT_I4
PROPID_ACC_NAV_LASTCHILD	VT_DISPATCH VT_I4