Używanie adnotacji serwera

Ten temat zawiera informacje o korzystaniu z adnotacji serwera w celu określenia obiektu wywołania zwrotnego.

Aby zastąpić właściwość określającą obiekt wywołania zwrotnego

1. Uzyskaj wskaźnik interfejsu IAccessible do dostępnego elementu, który ma zostać opatrzony adnotacją.
2. Wywołaj QueryInterface elementu dostępnego, aby uzyskać wskaźnik interfejsu IAccIdentity.
3. Wywołaj wskaźnik interfejsu IAccIdentity::GetIdentityString() w IAccIdentity, aby uzyskać ciąg, który jednoznacznie identyfikuje dostępny element, który ma być adnotacją.
4. Użyj CoCreateInstance lub CoCreateInstanceEx, aby utworzyć obiekt IAccPropServices.
5. Utwórz obiekt Modelu obiektów składników (COM), który implementuje IAccPropServer.
6. Wywołaj IAccPropServices::SetPropServer, przekazując ciąg tożsamości, identyfikator GUID wskazujący właściwość, która ma zostać zastąpiona, oraz wskaźnik do obiektu wywołania zwrotnego IAccPropServer.
7. Zwolnij wskaźniki interfejsu i zwolnij pamięć.

Gdy klient zażąda właściwości dostępnego elementu, obiekt wywołania zwrotnego zostanie wywołany i przekaże wartość klientowi.

Jak przy określaniu wartości, deweloperzy serwerów mogą alternatywnie użyć metody IAccPropServices::ComposeHwndIdentityString, aby uzyskać ciąg tożsamości, lub mogą skorzystać z metody IAccPropServices::SetHwndPropServer i zamiast ciągu tożsamości określić parametry hwnd, idObjectlub idChild.

W przypadku korzystania z SetPropServer lub SetHwndPropServer w obiekcie kontenera deweloperzy serwera mogą opcjonalnie określić, że zastępowanie informacji powinno również dotyczyć wszystkich elementów podrzędnych tego kontenera.

Serwery mogą jawnie wyczyścić adnotację w dowolnym momencie przy użyciu IAccPropServices::ClearProps. Zwykle nie jest to wymagane, ponieważ usługa adnotacji automatycznie czyści i zwalnia informacje adnotacji, gdy znika dostępny element, który jest adnotowany.

Poniżej znajduje się lista właściwości, które można dodać do adnotacji przy użyciu tej procedury.

Właściwości obsługiwane podczas definiowania wywołania zwrotnego

Podczas określania wywołania zwrotnego można dodać adnotacje do następujących właściwości. Obecnie te właściwości nie mogą być bezpośrednio oznaczone adnotacjami przez określenie wartości.