Verwenden der direkten Anmerkung

So verwenden Sie die direkte Anmerkung, um den Wert einer Eigenschaft zu überschreiben

  1. Verwenden Sie die Funktion CoCreateInstance oder CoCreateInstanceEx, um das IAccPropServices-Objekt zu erstellen.
  2. Rufen Sie IAccPropServices::SetHwndPropauf, 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 mit Anmerkungen kommentiert.
  3. Geben Sie die Schnittstellenzeker frei, und geben Sie Arbeitsspeicher frei.

Im folgenden Beispiel wird veranschaulicht, wie die Role-Eigenschaft eines statischen Textsteuerfelds mit Anmerkungen kommentiert 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;
}

Eigenschaften, die beim Angeben eines Werts unterstützt werden

Die folgenden Microsoft Active Accessibility eigenschaften können beim Angeben eines Werts (wobei der Wert vom notierten Typ sein muss) für direkte Anmerkungen mit Anmerkungen kommentiert werden. Zum Überschreiben oder Hinzufügen einer Microsoft Benutzeroberflächenautomatisierung-Eigenschaft zu einem Steuerelement können Sie die Benutzeroberflächenautomatisierung-Eigenschaften-ID anstelle der Microsoft Active Accessibility angeben. Eine Liste der 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