InkPicture.SetWindowInputRectangle-Methode

Artikel
11/26/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 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
)

Parameter

windowInputRectangle
Typ: System.Drawing.Rectangle
Das Eingaberechteck in Fensterkoordinaten.

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 für die 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. Beispielsweise ist ein Rechteck mit den Parametern {500, 500, 400, 400} 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 InkPicture-Objekts mit dem Namen theInkPicture festzulegen, an das er angefügt ist.

[C#]

using Microsoft.Ink;
//...
InkPicture theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkPicture(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkPicture.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 InkPicture-Objekts mit dem Namen theInkPicture festzulegen, an das er angefügt ist.

[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

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.