InkOverlay.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 InkOverlay
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 a un rectángulo vacío con las coordenadas predeterminadas, pase {0,0,0,0} en la llamada al método SetWindowInputRectangle, en lugar de nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic .NET).

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.

Ejemplos

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

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

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

Imports Microsoft.Ink
Dim theInkOverlay As InkOverlay
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkOverlay = New InkOverlay(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkOverlay.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.