Condividi tramite

Metodo IOleObject::SetHostNames (oleidl.h)

  • Articolo

Fornisce un oggetto con i nomi dell'applicazione contenitore e il documento composto in cui è incorporato.

Sintassi

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

Parametri

[in] szContainerApp

Puntatore al nome dell'applicazione contenitore in cui viene eseguito l'oggetto.

[in] szContainerObj

Puntatore al nome del documento composito contenente l'oggetto. Se non si desidera visualizzare il nome del documento composto, è possibile impostare questo parametro su NULL.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo.

Commenti

Note per i chiamanti

Chiamare IOleObject::SetHostNames solo per gli oggetti incorporati, perché per gli oggetti collegati, l'origine del collegamento fornisce informazioni separate sulla finestra di modifica e sulla barra del titolo.

Note per gli implementatori

L'applicazione di un oggetto di IOleObject::SetHostNames deve includere qualsiasi modifica all'interfaccia utente possa essere appropriata allo stato incorporato di un oggetto. Tali modifiche in genere includono l'aggiunta e la rimozione di comandi di menu e la modifica del testo visualizzato nella barra del titolo della finestra di modifica.

Il titolo completo della finestra per un oggetto incorporato in un'applicazione contenitore SDI o un'applicazione MDI con una finestra figlio ingrandita dovrebbe essere visualizzata come segue:

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

In caso contrario, il titolo deve essere:

<object application name> - <container document>

Il "tipo breve oggetto" si riferisce a una forma di nome di un oggetto sufficientemente breve da essere visualizzata completamente in una casella di riepilogo. Poiché queste stringhe di identificazione non vengono archiviate come parte dello stato permanente dell'oggetto, IOleObject::SetHostNames deve essere chiamato ogni volta che l'oggetto viene caricato o eseguito.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleidl.h

Vedi anche

Ioleobject

IOleObject::GetUserType