Compartir a través de

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

  • Artículo

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