Bereitstellen der Name-Eigenschaft

Serverentwickler müssen beim Erstellen vordefinierter und allgemeiner Steuerelemente darauf achten, dass Microsoft Active Accessibility die Name-Eigenschaft für das Steuerelement verfügbar machen kann. Abhängig vom Typ des Steuerelements stammt der Text für die Name-Eigenschaft aus einer der folgenden Elemente:

  • Der Fenstertext des Steuerelements (oder Untertitel)
  • Statischer Text, der das Steuerelement beschrifte

Um den Fenstertext des Steuerelements zu finden, sendet Microsoft Active Accessibility die meldung WM_GETTEXT an das Steuerelement. Dieser Text entspricht dem text-Parameter in der Ressourcendefinitionsanweisung des Steuerelements. Bei einigen Steuerelementen, z. B. Schaltflächen, ist dies derselbe Text, der mit dem -Steuerelement angezeigt wird. Bei anderen Steuerelementen, z. B. Symbolleisten, wird dieser Text nicht angezeigt. Daher müssen Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen, um Benutzern von Clienthilfsprogrammen bei der Identifizierung des Steuerelements zu helfen.

Um die Bezeichnung des Steuerelements zu finden, sucht Microsoft Active Accessibility nach einem statischen Textsteuerelement, indem GetWindow mit dem flag GW_HWNDPREV aufgerufen wird. Die Suche wird angehalten, wenn ein statisches Textsteuerelement gefunden wird oder wenn ein Steuerelement mit den Fensterformaten WS_GROUP | WS_TABSTOP. Diese Suchreihenfolge entspricht der umgekehrten Aktivierreihenfolge in einem Dialogfeld. Serverentwickler müssen beim Erstellen von Steuerelementen die Aktivierreihenfolge beachten, sodass dem Steuerelement, das es beschriftet, unmittelbar ein statisches Textsteuerelement vorangestellt wird.

Weitere Informationen zu den Techniken, die Microsoft Active Accessibility zum Verfügbarmachen der Name-Eigenschaft verwendet, finden Sie unter User Interface Element Reference.For more information about the techniques that Microsoft Active Accessibility uses to expose the Name property, see User Interface Element Reference.