IOleInPlaceUIWindow::SetActiveObject-Methode (oleidl.h)
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 |
|---|---|
|
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 |