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


Glossary Item Box

Gets or sets whether the control can receive focus and respond to user actions.

Syntax

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

Property Value

Boolean value: true if element is enabled; false otherwise

Remarks

If this property is set to true, you can still specify that the control cannot receive focus by setting the CanFocus property to false.

If the CanFocus property is set to true, you can move the focus to the control by calling the Focus method.

Contrast this property with the CanFocus property and the Selectable property. Use the CanFocus property to specify whether a control can receive the focus. Use the Selectable property to specify whether users can interact with the control, such as pressing a button.

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)
{
// Turn off the No Smoking sign
control.Visible = true;
control.Enabled = false;
control.Selectable = false;
control.CanFocus = false;
}
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
'Turn off the No Smoking sign
control.Visible = True
control.Enabled = False
control.Selectable = False
control.CanFocus = False
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.