InkPicture.SetWindowInputRectangle (Método)

Artículo
11/26/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 InkPicture
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
Rectángulo de entrada en coordenadas de ventana.

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 espaciales 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 InkPicture, theInkPicture, al que está asociado.

[C#]

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

En este ejemplo de Microsoft® 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 InkPicture, theInkPicture, al que está asociado.

[Visual Basic]

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