Spread Windows Forms 6.0 Product Documentation
Redraw Property
See Also  Example Support Options
FarPoint.Win Assembly > FarPoint.Win Namespace > ElementControl Class : Redraw Property


Glossary Item Box

Gets or sets whether the control automatically refreshes itself each time a property is set that changes the control or its value.

Syntax

Visual Basic (Declaration) 
Public Overridable Property Redraw As Boolean
Visual Basic (Usage)Copy Code
Dim instance As ElementControl
Dim value As Boolean
 
instance.Redraw = value
 
value = instance.Redraw
C# 
public virtual bool Redraw {get; set;}

Property Value

Boolean value: true to redraw; false otherwise

Remarks

Setting this property to false can speed up your application during certain operations. Set this property to false when adding large amounts of data or when making many changes to a control; then when you are finished, reset this property to true. The items on the screen that have changed since this property was set to false are then refreshed.

When the control receives the focus, the control sets its Redraw property to true.

This property is available at run time only.

Note: Even if you set this property to false, some changes might be shown on the screen, depending on the type of changes and the order in which they are made.

Example

C#Copy Code
control.Picture = Image.FromFile(Application.StartupPath + "\\smokes.bmp");
control.PictureMargin = 34;
control.MarginTop = 3;
control.MarginBottom = 3;
control.MarginLeft = 3;
control.MarginRight = 3;
control.PictureOrientation = FarPoint.Win.PictureOrientation.PictureRotate180;
control.AlignText = FarPoint.Win.TextAlign.TextLeftPictRight;
control.AlignHorz = FarPoint.Win.HorizontalAlignment.Left;
control.BackColor = Color.Red;
control.Text = "NO SMOKING";
private void button1_Click(object sender, System.EventArgs e)
{
     control.Redraw = true;
}
Visual BasicCopy Code
control.Picture = Image.FromFile(Application.StartupPath & "\smokes.bmp")
control.PictureMargin = 34
control.MarginTop = 3
control.MarginBottom = 3
control.MarginLeft = 3
control.MarginRight = 3
control.PictureOrientation = FarPoint.Win.PictureOrientation.PictureRotate180
control.MarginTop = 3
control.MarginBottom = 3
control.AlignText = FarPoint.Win.TextAlign.TextLeftPictRight
control.AlignHorz = FarPoint.Win.HorizontalAlignment.Left
control.BackColor = Color.Red
control.Text = "NO SMOKING"
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
     control.Redraw = True
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.