Freigeben über

ObjectModel-Steuerelementmuster

  • Artikel

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 von Microsoft Benutzeroberflächenautomatisierung hinaus bieten. Dieses Steuerelementmuster ermöglicht es einem Client, von einem Benutzeroberflächenautomatisierung-Element zum zugrunde liegenden Objektmodell zu 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 dem Quellbenutzeroberflächenelement so nahe wie möglich ist. In einem Webbrowser sollte beispielsweise ein Benutzeroberflächenautomatisierung Anbieter für ein einzelnes Element einen Objektmodellzeiger für das Element zurückgeben. Das Zurückgeben eines Objektmodellzeigers für den Dokumentstamm wäre viel weniger nützlich.
  • Es wird erwartet, dass der Client des ObjectModel-Steuerelementmusters über die IID für die gesuchte Schnittstelle verfügt, weshalb es ausreicht, einen einfachen IUnknown-Zeiger zurückzugeben.
  • Da Benutzeroberflächenautomatisierung den Zeiger auf den Clientprozess marshallt, sollte der Anbieter erwarten, dass der Client auf das Objektmodell mithilfe der COM-Standardpraktiken (Component Object Model) zugreift.

Erforderliche Member für IObjectModelProvider

Die folgende Methode ist erforderlich, um die IObjectModelProvider-Schnittstelle zu implementieren.

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 Objektmodellzeiger 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