Metodo IOleInPlaceUIWindow::SetActiveObject (oleidl.h)

Articolo
03/01/2024

Fornisce un canale diretto di comunicazione tra l'oggetto e ognuna delle finestre cornice e documento.

Sintassi

HRESULT SetActiveObject(
  [in] IOleInPlaceActiveObject *pActiveObject,
  [in] LPCOLESTR               pszObjName
);

Parametri

[in] pActiveObject

Puntatore all'interfaccia IOleInPlaceActiveObject nell'oggetto sul posto attivo.

[in] pszObjName

Puntatore a una stringa contenente un nome che descrive l'oggetto che un contenitore di incorporamento può usare per comporre il titolo della finestra. Può essere NULL se l'oggetto non richiede al contenitore di modificare i titoli delle finestre. I contenitori devono ignorare questo parametro e usare sempre il proprio nome nella barra del titolo.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

In genere, un oggetto incorporato deve passare NULL per il parametro pszObjName (vedere Note per gli implementatori di seguito). Tuttavia, se si lavora insieme a un contenitore che visualizza il nome dell'oggetto attivo sul posto nella relativa barra del titolo, è necessario comporre una stringa nel formato seguente: <nome> applicazione - < nome >breve oggetto.

Note ai chiamanti

IOleInPlaceUIWindow::SetActiveObject viene chiamato dall'oggetto per stabilire un collegamento diretto di comunicazione tra se stesso e le finestre documento e cornice.

Quando si disattiva, l'oggetto chiama IOleInPlaceUIWindow::SetActiveObject, passando NULL per i parametri pActiveObject e pszObjName.

Un oggetto deve chiamare IOleInPlaceUIWindow::SetActiveObject prima di chiamare IOleInPlaceFrame::SetMenu per assegnare al contenitore il puntatore all'oggetto attivo. Il contenitore usa quindi questo puntatore nell'elaborazione di IOleInPlaceFrame::SetMenu e per passare a OleSetMenuDescriptor.

Note per gli implementatori

Nella Guida alla progettazione dell'interfaccia utente di Microsoft Windows è consigliabile che un contenitore sul posto ignori il parametro pszObjName passato in questo metodo. La guida indica "La barra del titolo non è interessata dall'attivazione sul posto. Visualizza sempre il nome del contenitore di primo livello."

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