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

Modifica 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 o 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 que 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 en {0,0,0,0}. 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 a 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, es posible que se produzcan resultados impredecibles cuando se cambie el tamaño de la ventana.

 

Nota Llamar a este método dentro de determinados controladores de mensajes puede provocar 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 Alt-Tab o combinaciones de teclas Alt-Esc). Se trata de un problema con las aplicaciones de modelo de apartamento de un solo subproceso.

 

Requisitos

Requisito	Value
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)

IInkPicture

InkPicture