Metodo InkCollector.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 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
)

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.

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.

Nota

Se chiamata all'interno di alcuni gestori di messaggi è possibile che questa funzione venga reimmessa, provocando risultati imprevisti. Prestare attenzione per evitare una chiamata rientrante durante la gestione di uno dei messaggi seguenti: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT, WM_SYSCOMMAND se wParam è impostato su SC_HOTKEY o SC_TASKLIST e WM_SYSKEYDOWN (durante l'elaborazione delle combinazioni di tasti ALT-TAB o ALT-ESC). Questo problema è relativo alle applicazioni con modello di apartment a thread singolo.

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 InkCollector, theInkCollector, al quale è associata.

using Microsoft.Ink;
//...
InkCollector theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkCollector(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkCollector.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 InkCollector, theInkCollector, al quale è associata.

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

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.