Verwenden der direkten Anmerkung

So verwenden Sie die direkte Anmerkung zum Überschreiben des Werts einer Eigenschaft

1. Verwenden Sie die Funktion CoCreateInstance oder CoCreateInstanceEx , um das IAccPropServices-Objekt zu erstellen.
2. Rufen Sie IAccPropServices::SetHwndProp auf, und übergeben Sie den HWND, die Objekt-ID, die untergeordnete ID, die zu überschreibende Eigenschaft und einen VARIANT-Wert , der den neuen Wert der Eigenschaft enthält. In diesem Schritt wird der Wert kommentiert.
3. Lassen Sie die Schnittstellenzeiger los und geben Sie Arbeitsspeicher frei.

Das folgende Beispiel zeigt, wie die Role-Eigenschaft eines statischen Textsteuerelements mit Anmerkungen versehen wird.

HRESULT CMyTextControl::SetAccessibleProperties()
{
  // COM is assumed to be initialized...
  IAccPropServices* pAccPropServices = NULL;

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

  if (SUCCEEDED(hr))
  {
    // Annotating the Role of this object to be STATICTEXT
    VARIANT var;
    var.vt = VT_I4;
    var.lVal = ROLE_SYSTEM_STATICTEXT;

    hr = pAccPropServices->SetHwndProp(_hwnd,
      OBJID_CLIENT,
      CHILDID_SELF,
      PROPID_ACC_ROLE,
      var);

    pAccPropServices->Release();
  }
  return hr;
}

Beim Angeben eines Werts unterstützte Eigenschaften

Die folgenden Microsoft Active Accessibility-Eigenschaften können beim Angeben eines Werts (wobei der Wert vom notierten Typ sein muss) für die direkte Anmerkung mit Anmerkungen versehen werden. Zum Überschreiben oder Hinzufügen einer Microsoft Benutzeroberflächenautomatisierung-Eigenschaft zu einem Steuerelement können Sie anstelle der Microsoft Active Accessibility-Eigenschafts-ID die Benutzeroberflächenautomatisierung-Eigenschafts-ID angeben. Eine Liste mit Benutzeroberflächenautomatisierung IDs finden Sie unter Eigenschaftenbezeichner.

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