InkOverlay.AutoRedraw, propriété
Mise à jour : November 2007
Obtient ou définit une valeur qui spécifie si l'objet InkOverlay 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
<BrowsableAttribute(True)> _
Public Property AutoRedraw As Boolean
'Utilisation
Dim instance As InkOverlay
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 l'objet InkOverlay repeint l'entrée manuscrite lorsque la fenêtre n'est pas valide.
true si l'objet InkOverlay repeint l'entrée manuscrite lorsque la fenêtre a été invalidée ; sinon, false.
Notes
La valeur pour AutoRedraw spécifie si l'objet Ink actuellement associé à l'objet InkOverlay est automatiquement redessiné lorsque la fenêtre associée à l'objet InkOverlay reçoit une notification Paint (page pouvant être en anglais). Par exemple, si la valeur est 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 à mesure qu'elle est tracée, sauf si la propriété DynamicRendering a la valeur false.
Lorsque 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 l'objet InkOverlay. Dans ce cas, ajoutez un délégué au gestionnaire d'événements OnPainted de l'objet InkOverlay 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 InkOverlay 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.
Informations de version
.NET Framework
Pris en charge dans : 3.0