IOleInPlaceUIWindow::SetActiveObject-Methode (oleidl.h)

Artikel
03/06/2024

Stellt einen direkten Kommunikationskanal zwischen dem Objekt und den einzelnen Frame- und Dokumentfenstern bereit.

Syntax

HRESULT SetActiveObject(
  [in] IOleInPlaceActiveObject *pActiveObject,
  [in] LPCOLESTR               pszObjName
);

Parameter

[in] pActiveObject

Ein Zeiger auf die IOleInPlaceActiveObject-Schnittstelle für das aktive direkte Objekt.

[in] pszObjName

Ein Zeiger auf eine Zeichenfolge, die einen Namen enthält, der das Objekt beschreibt, das ein Einbettungscontainer beim Verfassen des Fenstertitels verwenden kann. Es kann NULL sein, wenn das Objekt nicht erfordert, dass der Container seine Fenstertitel ändert. Container sollten diesen Parameter ignorieren und immer ihren eigenen Namen in der Titelleiste verwenden.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Im Allgemeinen sollte ein eingebettetes Objekt NULL für den pszObjName-Parameter übergeben (siehe Hinweise zu Implementern unten). Wenn Sie jedoch in Verbindung mit einem Container arbeiten, der den Namen des aktiven Objekts in der Titelleiste anzeigt, sollten Sie eine Zeichenfolge in der folgenden Form erstellen: <Anwendungsname> – <Kurztypname> des Objekts.

Hinweise für Anrufer

IOleInPlaceUIWindow::SetActiveObject wird vom -Objekt aufgerufen, um eine direkte Kommunikationsverbindung zwischen sich und den Dokument- und Rahmenfenstern herzustellen.

Beim Deaktivieren ruft das Objekt IOleInPlaceUIWindow::SetActiveObject auf und übergibt NULL für die Parameter pActiveObject und pszObjName.

Ein Objekt muss IOleInPlaceUIWindow::SetActiveObject aufrufen, bevor IOleInPlaceFrame::SetMenu aufgerufen wird, um dem Container den Zeiger auf das aktive Objekt zu geben. Der Container verwendet diesen Zeiger dann bei der Verarbeitung von IOleInPlaceFrame::SetMenu und zur Übergabe an OleSetMenuDescriptor.

Hinweise für Implementierer

Im Entwurfshandbuch zur Microsoft Windows-Benutzeroberfläche wird empfohlen, dass ein in-situ-Container den parameter pszObjName ignoriert, der in dieser Methode übergeben wird. Der Leitfaden besagt: "Die Titelleiste ist von der direkten Aktivierung nicht betroffen. Es wird immer der Name des Containers der obersten Ebene angezeigt."

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleidl.h