Metodo InkOverlay.SetWindowInputRectangle

Articolo
10/29/2008

Aggiornamento: novembre 2007

Imposta il rettangolo della finestra, espresso in pixel, in cui viene disegnato l'input penna.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
'Utilizzo
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
)

Parametri

windowInputRectangle
Tipo: System.Drawing.Rectangle
Rettangolo per l'input.

Note

Per impostazione predefinita, il rettangolo di input della finestra è impostato su {0,0,0,0}. Il mapping di questo rettangolo predefinito viene eseguito alla dimensione dell'intera finestra.

Per reimpostare il rettangolo di input della finestra come rettangolo vuoto con le coordinate predefinite, passare i parametri {0,0,0,0} nella chiamata al metodo SetWindowInputRectangle, anziché nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic .NET).

Non è possibile passare un rettangolo in cui il valore della proprietà Right sia inferiore rispetto al valore della proprietà Left oppure il valore della proprietà Bottom sia inferiore rispetto al valore della proprietà Top. Ad esempio, un rettangolo con parametri pari a {500, 500, 400, 400} non è valido.

Specificare un rettangolo nello spazio negativo della coordinata è possibile, ma inutile, perché verrebbe generata sempre una finestra sulla quale l'input penna non può essere immesso.

Avviso

Se si imposta il rettangolo di input della finestra in modo che sia sovrapposto a un controllo Splitter o ai bordi della finestra, si potrebbero verificare risultati imprevisti quando la finestra viene ridimensionata.

Esempi

In questo esempio di C# viene chiamato il metodo SetWindowInputRectangle per impostare l'area dell'input penna sulle dimensioni dell'intera finestra dell'oggetto InkOverlay, theInkOverlay, al quale è associata.

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

In questo esempio di Visual Basic .NET viene chiamato il metodo SetWindowInputRectangle per impostare l'area dell'input penna sulle dimensioni dell'intera finestra dell'oggetto InkOverlay, theInkOverlay, al quale è associata.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.