Serveraantekening gebruiken

Dit onderwerp bevat informatie over het gebruik van serveraantekening om een callback-object op te geven.

Een eigenschap die een callback-object aangeeft overschrijven

1. Haal een IAccessible interface-aanwijzer op voor het toegankelijk te annoteren element.
2. Roep QueryInterface aan op het toegankelijke element om een IAccIdentity-interfaceaanwijzer op te halen.
3. Roep IAccIdentity::GetIdentityString() aan op de interfaceaanwijzer IAccIdentity om een tekenreeks te verkrijgen die het toegankelijke element identificeert dat moet worden geannoteerd.
4. Gebruik CoCreateInstance of CoCreateInstanceEx om het -object IAccPropServices te maken.
5. Maak een COM-object (Component Object Model) dat IAccPropServer-implementeert.
6. Roep IAccPropServices::SetPropServeraan, waarbij de identiteitsreeks wordt doorgegeven, een GUID die aangeeft dat de eigenschap moet worden overschreven, en een pointer naar de IAccPropServer callback-object.
7. Bevrijd interfacewijzers en maak het geheugen vrij.

Wanneer een client de eigenschap van het toegankelijke element aanvraagt, wordt het callback-object aangeroepen en wordt de waarde naar de client geretourneerd.

Net als bij het opgeven van een waarde kunnen serverontwikkelaars ook de methode IAccPropServices::ComposeHwndIdentityString gebruiken om een identiteitstekenreeks te verkrijgen; of ze kunnen de methode IAccPropServices::SetHwndPropServer gebruiken en de hwnd, idObjectof idChild parameters opgeven in plaats van een identiteitstekenreeks.

Wanneer u SetPropServer of SetHwndPropServer op een containerobject gebruikt, kunnen serverontwikkelaars eventueel opgeven dat de overschrijvende informatie ook van toepassing moet zijn op alle onderliggende elementen van die container.

Servers kunnen de aantekening op elk gewenst moment expliciet wissen met behulp van IAccPropServices::ClearProps. Dit is meestal niet vereist, omdat de annotatieservice automatisch annotatiegegevens opschoont en vrijgeeft wanneer het toegankelijke element dat wordt geannoteerd verdwijnt.

Hieronder ziet u een lijst met eigenschappen die kunnen worden geannoteerd met behulp van deze procedure.

Ondersteunde eigenschappen bij specificeren van een callback

Wanneer u een callback opgeeft, kunnen de volgende eigenschappen worden geannoteerd. Deze eigenschappen kunnen momenteel niet rechtstreeks worden geannoteerd door een waarde op te geven.

Eigenschap	Type
PROPID_ACC_NAME	VT_BSTR
PROPID_ACC_OMSCHRIJVING	VT_BSTR
PROPID_ACC_ROLE	VT_I4
PROPID_ACC_STATE	VT_I4
PROPID_ACC_HELP	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
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
PROPID_ACC_NAV_PREV	VT_DISPATCH VT_I4
PROPID_ACC_NAV_VOLGENDE	VT_DISPATCH VT_I4
PROPID_ACC_NAV_FIRSTCHILD	VT_DISPATCH VT_I4
PROPID_ACC_NAV_LASTCHILD	VT_DISPATCH VT_I4