Verwenden von Serveranmerkungen
Dieses Thema enthält Informationen zur Verwendung von Serveranmerkungen zum Angeben eines Rückrufobjekts.
So überschreiben Sie eine Eigenschaft, die ein Rückrufobjekt angibt
- Rufen Sie einen IAccessible-Schnittstellenzeiger auf das barrierefreie Element ab, das mit Anmerkungen versehen werden soll.
- Rufen Sie QueryInterface für das barrierefreie Element auf, um einen IAccIdentity-Schnittstellenzeiger abzurufen.
- Rufen Sie IAccIdentity::GetIdentityString() auf dem IAccIdentity-Schnittstellenzeiger auf, um eine Zeichenfolge abzurufen, die das barrierefreie Element eindeutig identifiziert, das mit Anmerkungen versehen werden soll.
- Verwenden Sie CoCreateInstance oder CoCreateInstanceEx , um das IAccPropServices-Objekt zu erstellen.
- Erstellen Sie ein COM-Objekt (Component Object Model), das IAccPropServer implementiert.
- Rufen Sie IAccPropServices::SetPropServer auf, und übergeben Sie die Identitätszeichenfolge, eine GUID, die die zu überschreibende Eigenschaft angibt, und einen Zeiger auf das IAccPropServer-Rückrufobjekt .
- Freigeben von Schnittstellenzeigern und freiem Arbeitsspeicher.
Wenn ein Client die -Eigenschaft des barrierefreien Elements anfordert, wird das Rückrufobjekt aufgerufen und gibt den Wert an den Client zurück.
Wie beim Angeben eines Werts können Serverentwickler alternativ die IAccPropServices::ComposeHwndIdentityString-Methode verwenden, um eine Identitätszeichenfolge abzurufen. oder sie können die IAccPropServices::SetHwndPropServer-Methode verwenden und anstelle einer Identitätszeichenfolge die Parameter hwnd, idObject oder idChild angeben.
Bei Verwendung von SetPropServer oder SetHwndPropServer in einem Containerobjekt können Serverentwickler optional angeben, dass die überschreibenden Informationen auch für alle untergeordneten Elemente dieses Containers gelten sollen.
Server können die Anmerkung mithilfe von IAccPropServices::ClearProps jederzeit explizit löschen. Dies ist in der Regel nicht erforderlich, da der Anmerkungsdienst automatisch sauber und Anmerkungsinformationen freigibt, wenn das barrierefreie Element, das kommentiert wird, verschwindet.
Im Folgenden finden Sie eine Liste der Eigenschaften, die mit dieser Prozedur kommentiert werden können.
Beim Angeben eines Rückrufs unterstützte Eigenschaften
Wenn Sie einen Rückruf angeben, können die folgenden Eigenschaften mit Anmerkungen versehen werden. Derzeit können diese Eigenschaften nicht direkt durch Angabe eines Werts kommentiert werden.
| Eigenschaft | type |
|---|---|
| PROPID_ACC_NAME | VT_BSTR |
| PROPID_ACC_DESCRIPTION | 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_NEXT | VT_DISPATCH VT_I4 |
| PROPID_ACC_NAV_FIRSTCHILD | VT_DISPATCH VT_I4 |
| PROPID_ACC_NAV_LASTCHILD | VT_DISPATCH VT_I4 |