Enabled Property (ElementControl)

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

Syntax

Visual Basic
C#

'Declaration
 
Public Overridable Shadows Property Enabled As Boolean

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

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

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 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
'Turn off the No Smoking sign
control.Visible = True
control.Enabled = False
control.Selectable = False
control.CanFocus = False
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
CanFocus Property
DrawFocusRectangle Property
Focus(Boolean) Method
Selectable Property