InkCollector.AutoRedraw, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient ou définit une valeur qui spécifie si l'objet InkCollector repeint l'entrée manuscrite lorsque la fenêtre n'est pas valide.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Property AutoRedraw As Boolean
'Utilisation
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)

Valeur de propriété

Type : System.Boolean
true si l'objet InkCollector repeint l'entrée manuscrite lorsque la fenêtre est invalidée ; sinon, false.

Notes

La valeur pour AutoRedraw spécifie si l'objet Ink actuellement associé à l'objet InkCollector est automatiquement redessiné lorsque la fenêtre associée à l'objet InkCollector reçoit une notification Paint (page pouvant être en anglais). Par exemple, si AutoRedraw a la valeur true, lorsque vous réduisez la fenêtre et que vous la restaurez, l'entrée manuscrite est automatiquement retracée. Si la propriété a la valeur false, lorsque vous réduisez la fenêtre et que vous la restaurez, l'entrée manuscrite disparaît de la vue.

Lorsque la propriété AutoRedraw a la valeur false, l'entrée manuscrite apparaît à la saisie manuscrite, sauf si la propriété DynamicRendering a la valeur false.

Si votre application exécute un rendu personnalisé ou si elle est sensible aux touches de peinture, vous pouvez effectuer une nouvelle peinture et affecter la valeur false à la propriété AutoRedraw pour le contrôle InkPicture. Dans ce cas, ajoutez un délégué au gestionnaire d'événements OnPaint (page pouvant être en anglais) du contrôle sous-jacent pour tracer l'entrée manuscrite vous-même ou gérer l'événement Invalidate (page pouvant être en anglais) du contrôle sous-jacent pour modifier l'objet InvalidateEventArgs (page pouvant être en anglais).

Exemples

Cet exemple affiche des traits dans un objet InkCollector en affectant la valeur false à la propriété AutoRedraw, puis en traçant manuellement l'entrée manuscrite. Le gestionnaire d'événements Paint (page pouvant être en anglais) du contrôle auquel le InkCollector est attaché vérifie la taille de chaque trait. Si le trait est inférieur à 400 unités d'espace d'entrée manuscrite, il s'affiche en bleu.

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);
            }
        }
    }

}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.