Beispiel für Freihandsammlung

Diese Anwendung basiert auf dem InkCollector-Objekt und veranschaulicht die Auflistung von Freihand. Die Anwendung erstellt ein Fenster, fügt ein InkCollector-Objekt an und stellt dem Benutzer Menüoptionen zur Verfügung, die zum Ändern der Freihandfarbe, der Freihandbreite sowie zum Aktivieren und Deaktivieren der Freihandsammlung verwendet werden können.

Hinweis

Die in diesem Abschnitt erläuterte Version ist Visual Basic .NET. Die Konzepte sind in anderen Sprachversionen in der Beispielbibliothek identisch.

 

Deklarieren des InkCollectors

Die Anwendung importiert zuerst den Microsoft.Ink-Namespace . Anschließend deklariert myInkCollectordie Anwendung , die das InkCollector-Objekt für das Formular enthält.

' The Ink namespace, which contains the Tablet PC Platform APIImports Microsoft.Ink
...
Public Class InkCollection
   Inherits Form
    ' Declare the Ink Collector object
    Private myInkCollector

Einrichten von Elementen

Die -Methode des Formulars InkCollection_Load behandelt das Load-Ereignis des Formulars. Es erstellt ein Dem Formular zugewiesenes InkCollector-Objekt ändert die DefaultDrawingAttributes-Eigenschaft des InkCollector-Objekts und aktiviert das InkCollector-Objekt.

Private Sub InkCollection_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    ' Create an ink collector and assign it to this form's window
    myInkCollector = New InkCollector(Me.Handle)

    ' Set the pen width to be a medium width
    myInkCollector.DefaultDrawingAttributes.Width = MediumInkWidth

    ' If you do not modify the default drawing attributes, the default 
    ' drawing attributes will use the following properties and values:
    ' ...

    ' Turn the ink collector on
    myInkCollector.Enabled = True
End Sub

Der InkCollector wird dem Fenster des Formulars zugewiesen, indem das Fensterhandle des Formulars der Handle-Eigenschaft des InkCollector-Objekts zugewiesen wird. Die Freihandauflistung wird aktiviert, indem die Enabled-Eigenschaft des InkCollector-Objekts auf TRUE festgelegt wird.

Die DefaultDrawingAttributes-Eigenschaft des InkCollector-Objekts legt die Standardattribute fest, die einem neuen Cursor zugewiesen sind. Verwenden Sie die DrawingAttributes-Eigenschaft des Cursor-Objekts , um verschiedene Attribute für einen neuen Cursor festzulegen. Verwenden Sie die DrawingAttributes-Eigenschaft des Stroke-Objekts , um die Zeichnungsattribute eines einzelnen Strichs zu ändern.

Ändern der Eigenschaften

Der Rest dieser einfachen Anwendung besteht aus Handlern für die verschiedenen Menüauswahlen, die der Benutzer treffen kann. Wenn der Benutzer beispielsweise die Freihandfarbe in Rot durch Auswählen von Rot im Freihandmenü ändert, wird die Farbe mithilfe der Color-Eigenschaft der DefaultDrawingAttributes-Eigenschaft des InkCollector-Objekts im Ereignishandler für das Menü geändert.

Private Sub miRed_Click(ByVal sender As System.Object, 
                        ByVal e As System.EventArgs) Handles miRed.Click
    myInkCollector.DefaultDrawingAttributes.Color = Color.Red
End Sub

Schließen des Formulars

Die Dispose-Methode des Formulars verwirf das InkCollector-ObjektmyInkCollector.