Freigeben über

Objektmodell-Steuerelementmuster

  • Artikel

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

Viele Anwendungen implementieren umfangreiche Objektmodelle, die über die Von Microsoft-Benutzeroberflächenautomatisierung hinausgehen. Mit diesem Steuerelementmuster kann ein Client von einem Benutzeroberflächenautomatisierungs-Element zum zugrunde liegenden Objektmodell navigieren.

Dieses Thema enthält die folgenden Abschnitte.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des ObjectModel- Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Die IObjectModelProvider::GetUnderlyingObjectModel-Methode sollte einen Zeiger auf das Objekt zurückgeben, das dem Quell-UI-Element so nah wie möglich ist. Beispielsweise sollte in einem Webbrowser ein Benutzeroberflächenautomatisierungs-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.
  • Der Client des ObjectModel Steuerelementmusters wird erwartet, dass die IID für die gesuchte Schnittstelle vorhanden ist, weshalb es ausreicht, einen einfachen IUnknown Zeiger zurückzugeben.
  • Da die Benutzeroberflächenautomatisierung den Zeiger auf den Clientprozess marshallt, sollte der Anbieter erwarten, dass der Client mithilfe standardmäßiger COM-Methoden (Component Object Model) auf das Objektmodell zugreifen kann.

Erforderliche Elemente für IObjectModelProvider-

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

Erforderliche Mitglieder Elementtyp Notizen
GetUnderlyingObjectModel- Methode Gibt einen COM-Zeiger auf das zugrunde liegende Objektmodell zurück. Der Client wird erwartet, dass die IUnknown::QueryInterface Methode aufgerufen wird, um bestimmte Objektmodellzeiger abzurufen.

 

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur