Redraw Property (ElementControl)

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
C#

'Declaration
 
Public Overridable Property Redraw As Boolean

'Usage
 
Dim instance As ElementControl
Dim value As Boolean
 
instance.Redraw = value
 
value = instance.Redraw

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

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 Basic

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 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

Reference

ElementControl Class
ElementControl Members