InkCollector.AutoRedraw-Eigenschaft

Artikel
11/26/2008

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das InkCollector-Objekt die Freihandeingabe neu zeichnet, wenn das Fenster ungültig wird.

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

Syntax

'Declaration
Public Property AutoRedraw As Boolean
'Usage
Dim instance As InkCollector
Dim value As Boolean

value = instance.AutoRedraw

instance.AutoRedraw = value

public bool AutoRedraw { get; set; }

public:
property bool AutoRedraw {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_AutoRedraw()
/** @property */
public  void set_AutoRedraw(boolean value)

public function get AutoRedraw () : boolean
public function set AutoRedraw (value : boolean)

Eigenschaftenwert

Typ: System.Boolean
true , wenn das InkCollector-Objekt die Freihandeingabe neu zeichnet, sobald das Fenster ungültig wird; andernfalls false.

Hinweise

Der Wert für AutoRedraw gibt an, ob das derzeit dem InkCollector-Objekt zugeordnete Ink-Objekt automatisch neu gezeichnet wird, wenn das dem InkCollector-Objekt zugeordnete Fenster eine Paint-Benachrichtigung empfängt. Ist beispielsweise AutoRedraw auf true festgelegt, wird die Freihandeingabe automatisch neu gezeichnet, wenn Sie das Fenster minimieren und anschließend wiederherstellen. Auf false festgelegt, verschwindet die Freihandeingabe jedoch aus der Ansicht, wenn Sie das Fenster minimieren und anschließend wiederherstellen.

Wenn AutoRedraw auf den Wert false festgelegt ist, wird das Freihandelement bei der Eingabe angezeigt, es sei denn, die DynamicRendering-Eigenschaft ist auf false festgelegt.

Wenn Ihre Anwendung ein benutzerdefiniertes Rendering durchführt oder wenn Ihre Anwendung gegenüber Zeichenproblemen empfindlich reagiert, können Sie das Neuzeichnen selbst behandeln und die AutoRedraw-Eigenschaft für das InkPicture-Steuerelement auf false festlegen. Fügen Sie in diesem Fall dem OnPaint-Ereignishandler des zugrundeliegenden Steuerelements einen Delegaten an, um die Freihandeingaben selbst zu zeichnen, oder behandeln Sie das Invalidate-Ereignis des zugrundeliegenden Steuerelements, um das InvalidateEventArgs-Objekt zu ändern.

Beispiele

In diesem Beispiel werden Striche in einem InkCollector-Objekt angezeigt, indem die AutoRedraw-Eigenschaft auf false festgelegt und das Freihandelement anschließend manuell gezeichnet wird. Der Paint-Ereignishandler für das Steuerelement, an das das InkCollector-Objekt angefügt ist, überprüft die Größe jedes Strichs. Wenn der Strich kleiner als 400 Freihandbereich-Einheiten ist, wird der Strich blau angezeigt.

Private Sub mInkObjectControl_Paint(ByVal sender As Object, ByVal e As PaintEventArgs)

    ' Check if AutoRedraw is off
    ' mInkObject can be InkCollector, InkOverlay, or InkPicture
    If Not mInkObject.AutoRedraw Then

        ' Draw each stroke manually
        For Each stroke As Stroke In mInkObject.Ink.Strokes
            ' See if this stroke is small
            Dim strokeBounds As Rectangle = stroke.GetBoundingBox()
            If strokeBounds.Width < 400 And strokeBounds.Height < 400 Then
                ' Change the drawing color to blue
                Dim newAttributes As DrawingAttributes = stroke.DrawingAttributes.Clone()
                newAttributes.Color = Color.Blue
                ' Draw with these special drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke, newAttributes)
            Else
                ' Draw stroke with its own drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke)
            End If
        Next
    End If

End Sub

private void mInkObjectControl_Paint(object sender, PaintEventArgs e)
{
    // Check if AutoRedraw is off
    // mInkObject can be InkCollector, InkOverlay, or InkPicture
    if (!mInkObject.AutoRedraw)
    {
        // Draw each stroke manually
        foreach (Stroke stroke in mInkObject.Ink.Strokes)
        {
            // See if this stroke is small
            Rectangle strokeBounds = stroke.GetBoundingBox();
            if (strokeBounds.Width < 400 && strokeBounds.Height < 400)
            {
                // Change the drawing color to blue
                DrawingAttributes newAttributes = stroke.DrawingAttributes.Clone();
                newAttributes.Color = Color.Blue;

                // Draw with these special drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke, newAttributes);
            }
            else
            {
                // Draw stroke with its own drawing attributes
                mInkObject.Renderer.Draw(e.Graphics, stroke);
            }
        }
    }

}

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.