Metodo IOleDocumentView::UIActivate (docobj.h)

Articolo
08/23/2023

Attiva o disattiva gli elementi dell'interfaccia utente di una visualizzazione documento, ad esempio menu, barre degli strumenti e acceleratori.

Sintassi

HRESULT UIActivate(
  [in] BOOL fUIActivate
);

Parametri

[in] fUIActivate

Se TRUE, la visualizzazione consiste nell'attivare l'interfaccia utente. Se FALSE, la visualizzazione consiste nel disattivare l'interfaccia utente.

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_FAIL	Operazione non riuscita.
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

Note ai chiamanti

La chiamata a questo metodo prima di chiamare IOleDocumentView::SetInPlaceSite restituisce E_UNEXPECTED, perché la visualizzazione deve essere associata a un sito di visualizzazione prima che possa attivarsi.

Quando IOleDocumentView::UIActivate viene chiamato come parte della sequenza di attivazione, la chiamata deve precedere una chiamata a IOleDocumentView::SetRect o IOleDocumentView::SetRectComplex, perché in caso contrario le dimensioni di visualizzazione non vrebbero dovuto tenere conto dello spazio della barra degli strumenti.

Per disattivare una visualizzazione, il contenitore deve chiamare IOleDocumentView::Show con FALSE, seguito da IOleDocumentView::UIActivate con FALSE.

Note per gli implementatori

Le implementazioni di questo metodo devono incarnare lo pseudocodice seguente.

if (fActivate)
    {
    UI activate the view (do menu merging, show frame level tools, process accelerators)
    Take focus, and bring the view window forward.
    }
else
    call IOleInPlaceObject::UIDeactivate on this view

Inoltre, la visualizzazione può e deve partecipare all'unione del menu Della Guida estesa.

Tutte le visualizzazioni di un oggetto documento devono supportare l'attivazione sul posto. E_NOTIMPL non è un valore restituito accettabile.

Requisiti


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