ObjectModel-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von IObjectModelProvider,einschließlich Informationen zu Methoden. Das ObjectModel-Steuerelementmuster wird verwendet, um einen Zeiger auf das zugrunde liegende Objektmodell eines Dokuments verfügbar zu machen.

Viele Anwendungen implementieren rich-Objektmodelle, die einen Mehrwert über das hinaus schaffen, was Microsoft Benutzeroberflächenautomatisierung bietet. Mit diesem Steuerelementmuster kann ein Client von einem Benutzeroberflächenautomatisierung zum zugrunde liegenden Objektmodell navigieren.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des ObjectModel-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Die IObjectModelProvider::GetUnderlyingObjectModel-Methode sollte einen Zeiger auf das Objekt zurückgeben, das sich so nah wie möglich am Benutzeroberflächenelement der Quelle befindet. In einem Webbrowser sollte beispielsweise ein Benutzeroberflächenautomatisierung für ein einzelnes Element einen Objektmodellzeiger für das Element zurückgeben. Die Rückgabe eines Objektmodellzeigers für den Dokumentstamm wäre weitaus weniger nützlich.
  • Es wird erwartet, dass der Client des ObjectModel-Steuerelementmusters über die IID für die gesuchte Schnittstelle verfügen soll. Aus diesem Grund reicht es aus, einen einfachen IUnknown-Zeiger zurückzuleiten.
  • Da Benutzeroberflächenautomatisierung Zeiger auf den Clientprozess marshallt, sollte der Anbieter davon ausgehen, dass der Client auf das Objektmodell mithilfe von Standardmethoden Component Object Model (COM) zugreifen kann.

Erforderliche Member für IObjectModelProvider

Die folgende Methode ist für die Implementierung der IObjectModelProvider-Schnittstelle erforderlich.

Erforderliche Member Memberart Hinweise
GetUnderlyingObjectModel Methode Gibt einen COM-Zeiger auf das zugrunde liegende Objektmodell zurück. Es wird erwartet, dass der Client die IUnknown::QueryInterface-Methode aufruft, um bestimmte Objektmodellzeigende abzurufen.

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Steuerelementtypen und ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur