IOleObject::SetHostNames-Methode (oleidl.h)
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 |