Método IInkCollector::SetWindowInputRectangle (msinkaut.h)

Establece el rectángulo de ventana, en píxeles, dentro del cual se dibuja la entrada de lápiz.

Sintaxis

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Parámetros

[in] WindowInputRectangle

Rectángulo, en coordenadas de ventana, en el que se dibuja la entrada de lápiz.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Un parámetro contenía un puntero no válido.
E_INVALIDARG	Las coordenadas del rectángulo no son válidas (por ejemplo, ancho/alto de 0).
E_INK_COLLECTOR_BUSY	No se pueden actualizar las asignaciones mientras se encuentra en medio de un trazo.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
E_INK_OVERLAPPING_INPUT_RECT	El rectángulo de entrada de ventana se superpone con el rectángulo de entrada de ventana de un inkCollector habilitado.

Comentarios

El error E_INK_OVERLAPPING_INPUT_RECT se devuelve si el rectángulo de entrada de ventana de un recopilador de tinta habilitado (establecido con la propiedad Enabled ) se superpone al rectángulo de entrada de ventana de otro recopilador de tinta habilitado.

Nota La superposición puede producirse sin un error siempre y cuando solo se habilite uno de los rectángulos de entrada en cualquier momento conocido.

 

De forma predeterminada, el rectángulo de entrada de la ventana se establece {0,0,0,0}en . Este rectángulo predeterminado se asigna al tamaño de toda la ventana.

Para restablecer el rectángulo de entrada de la ventana a su comportamiento predeterminado (un rectángulo vacío con coordenadas {0,0,0,0}), pase {0,0,0,0} la llamada a SetWindowInputRectangle y no NULL.

No se puede pasar un rectángulo donde el valor de la propiedad Right es menor que el valor de la propiedad Left ; o donde el valor de la propiedad Bottom es menor que el valor de la propiedad Top . Por ejemplo, un rectángulo con parámetros de {500, 500, 400, 400} no es válido.

Precaución Si establece el rectángulo de entrada de la ventana para superponer un control divisor o los bordes de la ventana, pueden producirse resultados imprevisibles cuando se cambia el tamaño de la ventana.

 

Nota Llamar a este método dentro de determinados controladores de mensajes puede dar lugar a que se vuelva a escribir la función subyacente, lo que provoca resultados inesperados. Tenga cuidado de evitar una llamada reentrant cuando controle cualquiera de los siguientes mensajes: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam está establecido en SC_HOTKEY o SC_TASKLIST; y WM_SYSKEYDOWN (al procesar combinaciones de teclas Alt+TAB o Alt+ESC). Se trata de un problema con las aplicaciones de modelo de apartamento de un solo subproceso.

 

Requisitos

Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	msinkaut.h
Library	InkObj.dll

Consulte también

Propiedad Enabled

GetWindowInputRectangle (método)

IInkCollector

Clase InkCollector