InkCollector.SetWindowInputRectangle-Methode

Artikel
10/28/2008

Legt das Fensterrechteck (in Pixel) fest, in dem Freihand gezeichnet wird.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

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

Parameter

windowInputRectangle
Typ: System.Drawing.Rectangle
Das Rechteck für die Eingabe.

Hinweise

Standardmäßig wird das Eingaberechteck für das Fenster auf {0,0,0,0} festgelegt. Dieses Standardrechteck wird der Größe des gesamten Fensters zugeordnet. Um das Eingaberechteck für das Fenster auf ein leeres Rechteck mit den Standardkoordinaten zurückzusetzen, übergeben Sie {0,0,0,0} im Aufruf der SetWindowInputRectangle-Methode.

Sie können kein Rechteck übergeben, dessen Wert für die Right-Eigenschaft kleiner als der Wert für die Left-Eigenschaft ist oder dessen Wert für die Bottom-Eigenschaft kleiner als der Wert für die Top-Eigenschaft ist. Ein Rechteck mit den Parametern {500, 500, 400, 400} ist beispielsweise nicht gültig.

Ein Rechteck kann im negativen Koordinatenraum angegeben werden. Es ist jedoch bedeutungslos, da immer ein Fenster erhalten wird, in dem keine Freihandeingabe möglich ist.

Warnung

Wenn Sie das Eingaberechteck für das Fenster so festlegen, dass es ein Splitter-Steuerelement oder die Ränder des Fensters überlappt, kann das Ändern der Fenstergröße zu unvorhersehbaren Ergebnissen führen.

Hinweis

Diese Funktion kann rekursiv ausgeführt werden, wenn sie in bestimmten Meldungshandlern aufgerufen wird, und unerwartete Ergebnisse verursachen. Vermeiden Sie unbedingt den wieder eintretenden Aufruf, wenn Sie eine der folgenden Meldungen behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT sowie WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist, und WM_SYSKEYDOWN (wenn die Tastenkombinationen ALT+TAB oder ALT+ESC verarbeitet werden). Dieses Problem tritt bei Anwendungen des Singlethread-Apartment-Modells auf.

Beispiele

In diesem C#-Beispiel wird die SetWindowInputRectangle-Methode aufgerufen, um den Bereich für die Freihandeingabe auf die Größe des gesamten Fensters des InkCollector-Objekts theInkCollector festzulegen, an das es angefügt ist.

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

In diesem Microsoft Visual Basic .NET-Beispiel wird die SetWindowInputRectangle-Methode aufgerufen, um den Bereich für die Freihandeingabe auf die Größe des gesamten Fensters des InkCollector-Objekts theInkCollector festzulegen, an das es angefügt ist.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.