Método IOleDocumentView::UIActivate (docobj.h)

Artículo
08/23/2023

Activa o desactiva los elementos de la interfaz de usuario de una vista de documento, como menús, barras de herramientas y aceleradores.

Sintaxis

HRESULT UIActivate(
  [in] BOOL fUIActivate
);

Parámetros

[in] fUIActivate

Si es TRUE, la vista es activar su interfaz de usuario. Si es FALSE, la vista es desactivar su interfaz de usuario.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	Error en la operación.
E_OUTOFMEMORY	Memoria insuficiente disponible para la operación.
E_UNEXPECTED	Se ha producido un error inesperado.

Comentarios

Notas a los autores de llamadas

Llamar a este método antes de llamar a IOleDocumentView::SetInPlaceSite devuelve E_UNEXPECTED, ya que la vista debe estar asociada a un sitio de vista antes de poder activarse.

Cuando se llama a IOleDocumentView::UIActivate como parte de la secuencia de activación, la llamada debe preceder a una llamada a IOleDocumentView::SetRect o IOleDocumentView::SetRectComplex, ya que, de lo contrario, las dimensiones de vista no tienen en cuenta el espacio de la barra de herramientas.

Para desactivar una vista, el contenedor debe llamar a IOleDocumentView::Show con FALSE, seguido de IOleDocumentView::UIActivate con FALSE.

Notas para los implementadores

Las implementaciones de este método deben incorporar el siguiente pseudocódigo.

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

Además, la vista puede participar y debe participar en la combinación de menús de Ayuda extendida.

Todas las vistas de un objeto de documento deben admitir la activación local. E_NOTIMPL no es un valor devuelto aceptable.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	docobj.h