Método IOleInPlaceSiteEx::OnInPlaceActivateEx (ocidl.h)

Artículo
02/29/2024

Llamado por el objeto incrustado para determinar si necesita volver a dibujarse tras la activación.

Sintaxis

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

Parámetros

[out] pfNoRedraw

Puntero a una variable que recibe el estado de nuevo dibujo actual. El estado es TRUE si el objeto no necesita volver a dibujarse tras la activación y FALSE en caso contrario. Normalmente, los objetos sin ventana no necesitan el valor devuelto por este parámetro y pueden pasar un puntero NULL para guardar el contenedor la carga de calcular este valor.

[in] dwFlags

Indica si el objeto se activa como un objeto sin ventanas. Este parámetro toma valores de la enumeración ACTIVATEFLAGS . Vea IOleInPlaceSiteWindowless para obtener más información sobre los objetos sin ventana.

Valor devuelto

Este método devuelve S_OK si el contenedor permite la activación local. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_UNEXPECTED	Se produjo un error inesperado.

Comentarios

Este método reemplaza A IOleInPlaceSite::OnInPlaceActivate. Si se usa el método anterior, el objeto siempre debe volver a dibujarse en la activación.

Los objetos sin ventana son necesarios para usar este método en lugar de IOleInPlaceSite::OnInPlaceActivate para notificar al contenedor si están activando sin ventanas o no.

Notas para los implementadores

El contenedor debe comprobar cuidadosamente el estado de invalidación del objeto, su orden z, el recorte y cualquier otro parámetro pertinente para determinar el valor adecuado que se va a devolver en pfNoRedraw.

Un contenedor puede almacenar en caché el valor de la enumeración ACTIVATEFLAGS en lugar de llamar al método GetWindow en la interfaz IOleInPlaceObjectWindowless repetidamente.

Requisitos

Requisito	Value
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	ocidl.h