InkOverlay.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 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
)

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 und nicht nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic .NET).

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.

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 InkOverlay-Objekts theInkOverlay festzulegen, das diesem zugeordnet ist.

using Microsoft.Ink;
//...
InkOverlay theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkOverlay(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkOverlay.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 InkOverlay-Objekts theInkOverlay festzulegen, das diesem zugeordnet ist.

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

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.