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 de retorno

Este método puede devolver uno de estos valores.

Código de retorno Descripción
S_OK
 Éxito.
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 la ventana se superpone con el rectángulo de entrada de ventana de un inkCollector habilitado.

Observaciones

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 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, los resultados imprevisibles pueden producirse 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

Requisito Importancia
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo admitido No se admite ninguno
de la plataforma de destino de Windows
Header msinkaut.h

Consulte también

Enabled (propiedad)

GetWindowInputRectangle (método)

IInkCollector

InkCollector (clase)

  • Last updated on