Método IPointerInactive::GetActivationPolicy (ocidl.h)
Recupera la directiva de activación actual para el objeto. El contenedor llama a este método al recibir un mensaje de WM_SETCURSOR o WM_MOUSEMOVE cuando un objeto inactivo está bajo el puntero del mouse.
Sintaxis
HRESULT GetActivationPolicy(
[out] DWORD *pdwPolicy
);
Parámetros
[out] pdwPolicy
Puntero a una variable que recibe la directiva de activación. Los valores posibles proceden de la enumeración POINTERINACTIVE .
Valor devuelto
Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, es E_FAIL.
Comentarios
El objeto puede solicitar que esté activado en contexto en cuanto el mouse lo introduzca a través del valor de POINTERINACTIVE_ACTIVATEONENTRY. Un objeto que proporciona más comentarios visuales que simplemente establecer el puntero del mouse usaría este valor. Por ejemplo, si el objeto admite comentarios visuales especiales, debe especificar el estado activo para que pueda dibujar los comentarios visuales que admite.
Un objeto también puede usar este método para solicitar la activación cuando el mouse se arrastra sobre ellos durante una operación de arrastrar y colocar a través del POINTERINACTIVE_ACTIVATEONDRAG.
Si el objeto devuelve uno de estos valores, el contenedor debe activar el objeto inmediatamente y reenviar el mensaje Window que desencadenó la llamada. A continuación, el objeto permanece activo y procesa los mensajes subsiguientes a través de su propia ventana hasta que el contenedor obtiene otro WM_SETCURSOR o WM_MOUSEMOVE. En este momento, el contenedor debe desactivar el objeto .
Para los objetos OLE sin ventana, este mecanismo es ligeramente diferente. Consulte IOleInPlaceSiteWindowless para obtener más información sobre las operaciones de arrastrar y colocar para objetos sin ventana.
Si el objeto devuelve los valores de POINTERINACTIVE_ACTIVATEONENTRY y POINTERINACTIVE_DEACTIVATEONLEAVE, el objeto solo se activa cuando el mouse está sobre el objeto. Si solo se establece el valor de POINTERINACTIVE_ACTIVATEONENTRY, el objeto se activa una vez cuando el mouse lo introduce por primera vez y permanece activo.
Notas a los autores de llamadas
La directiva de activación no debe almacenarse en caché. El contenedor debe llamar a este método cada vez que el mouse entra en un objeto inactivo.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 |