Partager via


InkPicture.AutoRedraw, propriété

Mise à jour : November 2007

Obtient ou définit une valeur qui spécifie si le contrôle InkPicture repeint l'entrée manuscrite lorsque la fenêtre est invalidée.

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

Syntaxe

'Déclaration
<BrowsableAttribute(True)> _
Public Property AutoRedraw As Boolean
'Utilisation
Dim instance As InkPicture
Dim value As Boolean

value = instance.AutoRedraw

instance.AutoRedraw = value
[BrowsableAttribute(true)]
public bool AutoRedraw { get; set; }
[BrowsableAttribute(true)]
public:
property bool AutoRedraw {
    bool get ();
    void set (bool value);
}
/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_AutoRedraw()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_AutoRedraw(boolean value)
public function get AutoRedraw () : boolean
public function set AutoRedraw (value : boolean)

Valeur de propriété

Type : System.Boolean
Valeur qui spécifie si le contrôle InkPicture repeint l'entrée manuscrite lorsque la fenêtre est invalidée.

Valeur

Signification

true

Le contrôle InkPicture repeint l'entrée manuscrite lorsque la fenêtre est invalidée.

false

Le contrôle InkPicture ne repeint pas l'entrée manuscrite lorsque la fenêtre est invalidée.

Notes

La valeur de la propriété AutoRedraw spécifie si l'objet Ink actuellement associé au contrôle InkPicture est automatiquement redessiné lorsque la fenêtre associée au contrôle InkPicture reçoit une notification Paint (page pouvant être en anglais). Par exemple, si la propriété 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 OnPainted du contrôle InkPicture pour tracer l'entrée manuscrite vous-même ou gérez l'événement Invalidate (page pouvant être en anglais) hérité pour qu'il modifie l'objet InvalidateEventArgs (page pouvant être en anglais).

Exemples

Cet exemple affiche des traits dans un contrôle InkPicture en affectant la valeur false à la propriété AutoRedraw, puis en traçant l'entrée manuscrite manuellement. Le gestionnaire de l'événement Paint (page pouvant être en anglais) pour le contrôle InkPicture 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.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

InkPicture, classe

Membres InkPicture

Microsoft.Ink, espace de noms

InkPicture.OnPainted

InkPicture.DynamicRendering

Autres ressources

System.Windows.Forms.Control.Invalidate Method (page pouvant être en anglais)