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
Autres ressources
System.Windows.Forms.Control.Invalidate Method (page pouvant être en anglais)