Adorner.Enabled Property

Reference

Definition

Namespace:: System.Windows.Forms.Design.Behavior

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating if the Adorner is enabled.

public:
 property bool Enabled { bool get(); void set(bool value); };

public bool Enabled { get; set; }

member this.Enabled : bool with get, set

Public Property Enabled As Boolean

Property Value

Boolean

true, if the Adorner is enabled; otherwise, false.

Examples

The following code example demonstrates how to enable and disable an Adorner. For a full code listing, see How to: Extend the Appearance and Behavior of Controls in Design Mode.

// The AnchorGlyph objects should mimic the resize glyphs;
// they should only be visible when the control is the 
// primary selection. The adorner is enabled when the 
// control is the primary selection and disabled when 
// it is not.

void selectionService_SelectionChanged(object sender, EventArgs e)
{
    if (object.ReferenceEquals(
        this.selectionService.PrimarySelection,
        this.relatedControl))
    {
        this.ComputeBounds();
        this.anchorAdorner.Enabled = true;
    }
    else
    {
        this.anchorAdorner.Enabled = false;
    }
}

' The AnchorGlyph objects should mimic the resize glyphs;
' they should only be visible when the control is the 
' primary selection. The adorner is enabled when the 
' control is the primary selection and disabled when 
' it is not.
Private Sub selectionService_SelectionChanged( _
ByVal sender As Object, _
ByVal e As EventArgs)

    If Object.ReferenceEquals( _
    Me.selectionService.PrimarySelection, _
    Me.relatedControl) Then
        Me.ComputeBounds()
        Me.anchorAdorner.Enabled = True
    Else
        Me.anchorAdorner.Enabled = False
    End If

End Sub

Remarks

If the Enabled property is true, the BehaviorService class will send HitTest and Paint messages to the Adorner.

Applies to

Share via