IOleObject::SetHostNames-Methode (oleidl.h)

  • Artikel

Stellt ein -Objekt mit den Namen seiner Containeranwendung und des Verbunddokuments bereit, in das es eingebettet ist.

Syntax

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

Parameter

[in] szContainerApp

Ein Zeiger auf den Namen der Containeranwendung, in der das Objekt ausgeführt wird.

[in] szContainerObj

Ein Zeiger auf den Namen des Verbunddokuments, das das Objekt enthält. Wenn Sie den Namen des zusammengesetzten Dokuments nicht anzeigen möchten, können Sie diesen Parameter auf NULL festlegen.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Hinweise für Anrufer

Rufen Sie IOleObject::SetHostNames nur für eingebettete Objekte auf, da die Linkquelle für verknüpfte Objekte ein eigenes Bearbeitungsfenster und Eigene Titelleisteninformationen bereitstellt.

Hinweise für Implementierer

Die Anwendung eines Objekts von IOleObject::SetHostNames sollte alle Änderungen an der Benutzeroberfläche enthalten, die für den eingebetteten Zustand eines Objekts geeignet sind. Solche Änderungen umfassen in der Regel das Hinzufügen und Entfernen von Menübefehlen und das Ändern des In der Titelleiste des Bearbeitungsfensters angezeigten Text.

Der vollständige Fenstertitel für ein eingebettetes Objekt in einer SDI-Containeranwendung oder einer MDI-Anwendung mit einem maximierten untergeordneten Fenster sollte wie folgt angezeigt werden:

<object application name> - <object short type> in <container document>

Andernfalls sollte der Titel wie folgt sein:

<object application name> - <container document>

Der "Objektkurztyp" bezieht sich auf eine Form des Objektnamens, der kurz genug ist, um vollständig in einem Listenfeld angezeigt zu werden. Da diese identifizierenden Zeichenfolgen nicht als Teil des persistenten Zustands des Objekts gespeichert werden, muss IOleObject::SetHostNames jedes Mal aufgerufen werden, wenn das Objekt geladen oder ausgeführt wird.

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

Weitere Informationen

IOleObject

IOleObject::GetUserType