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