InkCollector.SetWindowInputRectangle (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Establece el rectángulo de la ventana, en píxeles, dentro del que se dibuja la entrada manuscrita.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
'Uso
Dim instance As InkCollector
Dim windowInputRectangle As Rectangle

instance.SetWindowInputRectangle(windowInputRectangle)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public:
void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public function SetWindowInputRectangle(
    windowInputRectangle : Rectangle
)

Parámetros

windowInputRectangle
Tipo: System.Drawing.Rectangle
El rectángulo para la entrada.

Comentarios

De manera predeterminada, el rectángulo de entrada de la ventana se establece en {0,0,0,0}. Este rectángulo predeterminado se corresponde con el tamaño de toda la ventana. Para restablecer el rectángulo de entrada de la ventana en un rectángulo vacío con las coordenadas predeterminadas, pase {0,0,0,0} en la llamada al método SetWindowInputRectangle.

No puede pasar un rectángulo en el que el valor de la propiedad Right sea menor que el valor de la propiedad Left; o en el que el valor de la propiedad Bottom sea 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.

Se puede especificar un rectángulo con coordenadas de espacio negativas, pero puede que no tenga sentido, porque siempre genera una ventana en la que no se puede escribir a mano.

Advertencia

Si establece el rectángulo de entrada de la ventana para que se superponga a un control Splitter o a los bordes de la ventana, se pueden producir resultados imprevisibles cuando se cambie el tamaño de la ventana.

Nota

Esta función puede especificarse de nuevo si se llama en determinados controladores de mensajes, lo cual causa resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar alguno de los siguientes mensajes WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST, y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de contenedor uniproceso.

Ejemplos

En este ejemplo de C# se llama al método SetWindowInputRectangle para establecer el área de entrada de la entrada manuscrita al tamaño de ventana completa del objeto InkCollector, theInkCollector, al que está asociado.

using Microsoft.Ink;
//...
InkCollector theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkCollector(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkCollector.SetWindowInputRectangle(theRect);
    //...
}

En este ejemplo de Visual Basic .NET se llama al método SetWindowInputRectangle para establecer el área de entrada de la entrada manuscrita al tamaño de ventana completa del objeto InkCollector, theInkCollector, al que está asociado.

Imports Microsoft.Ink
Dim theInkCollector As InkCollector
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkCollector = New InkCollector(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkCollector.SetWindowInputRectangle(theRect)
    '...
End Sub

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.