Shape.Enabled-Eigenschaft

Artikel
10/24/2012

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob ein Linien-oder Formsteuerelement auf Benutzerinteraktionen reagieren kann.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property Enabled As Boolean

[BrowsableAttribute(true)]
public bool Enabled { get; set; }

[BrowsableAttribute(true)]
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

[<BrowsableAttribute(true)>]
member Enabled : bool with get, set

function get Enabled () : boolean
function set Enabled (value : boolean)

Eigenschaftswert

Typ: System.Boolean
true , wenn das Steuerelement auf Benutzerinteraktionen reagieren kann, andernfalls false.Die Standardeinstellung ist true.

Hinweise

Mit der Enabled-Eigenschaft können Sie Linien und Formen zur Laufzeit an dieser Option verhindern.Sie können Steuerelemente auch deaktivieren, die nicht den aktuellen Zustand der Anwendung gelten.Beispielsweise kann eine Form deaktiviert werden, damit der Benutzer beim Klicken darauf zugreifen können, bis eine bestimmte Bedingung erfüllt ist und das Verhalten einer Schaltfläche emulieren.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein RectangleShape-Steuerelement zur Laufzeit aktiviert und deaktiviert.Für diesen Code ist es erforderlich, dass Sie Form mit einem RectangleShape-Steuerelement und einem TextBox-Steuerelement daran haben.

Private Sub TextBox1_TextChanged() Handles TextBox1.TextChanged
    ' If the TextBox contains text, enable the RectangleShape.
    If TextBox1.Text <> "" Then
        ' Enable the RectangleShape.
        RectangleShape1.Enabled = True
        ' Change the BorderColor to the default.
        RectangleShape1.BorderColor = 
            Microsoft.VisualBasic.PowerPacks.Shape.DefaultBorderColor
    Else
        ' Disable the RectangleShape control.
        RectangleShape1.Enabled = False
        ' Change the BorderColor to show that the control is disabled
        RectangleShape1.BorderColor = 
            Color.FromKnownColor(KnownColor.InactiveBorder)
    End If
End Sub

private void textBox1_TextChanged(object sender, System.EventArgs e)
{
    // If the TextBox contains text, enable the RectangleShape.
    if (textBox1.Text != "")
    // Enable the RectangleShape.
    {
        rectangleShape1.Enabled = true;
        // Change the BorderColor to the default.
        rectangleShape1.BorderColor = Microsoft.VisualBasic.PowerPacks.Shape.DefaultBorderColor;
    }
    else
    {
        // Disable the RectangleShape control.
        rectangleShape1.Enabled = false;
        // Change the BorderColor to show that the control is disabled
        rectangleShape1.BorderColor = Color.FromKnownColor(KnownColor.InactiveBorder);
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.