UIElement.IsEnabled Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Ottiene o imposta un valore che indica se questo elemento è abilitato nell'interfaccia utente. Si tratta di una proprietà di dipendenza.

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

public bool IsEnabled { get; set; }

member this.IsEnabled : bool with get, set

Public Property IsEnabled As Boolean

Valore della proprietà

Boolean

true se l'elemento è abilitato; in caso contrario, false. Il valore predefinito è true.

Esempio

Nell'esempio seguente viene illustrato un gestore su un pulsante che, quando eseguito, imposta IsEnabledfalse su un altro pulsante denominato b1.

public partial class RoutedEventAddRemoveHandler {
    void MakeButton(object sender, RoutedEventArgs e)
    {
        Button b2 = new Button();
        b2.Content = "New Button";
        // Associate event handler to the button. You can remove the event 
        // handler using "-=" syntax rather than "+=".
        b2.Click  += new RoutedEventHandler(Onb2Click);
        root.Children.Insert(root.Children.Count, b2);
        DockPanel.SetDock(b2, Dock.Top);
        text1.Text = "Now click the second button...";
        b1.IsEnabled = false;
    }
    void Onb2Click(object sender, RoutedEventArgs e)
    {
        text1.Text = "New Button (b2) Was Clicked!!";
    }

Public Partial Class RoutedEventAddRemoveHandler
    Private Sub MakeButton(ByVal sender As Object, ByVal e As RoutedEventArgs)
        Dim b2 As Button = New Button()
        b2.Content = "New Button"
        AddHandler b2.Click, AddressOf Onb2Click
        root.Children.Insert(root.Children.Count, b2)
        DockPanel.SetDock(b2, Dock.Top)
        text1.Text = "Now click the second button..."
        b1.IsEnabled = False
    End Sub
    Private Sub Onb2Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        text1.Text = "New Button (b2) Was Clicked!!"
    End Sub

Commenti

Si noti che questa proprietà è influenzata da implementazioni specifiche della classe di IsEnabledCore su determinati elementi, spesso in fase di esecuzione. Di conseguenza, il valore predefinito elencato qui non è a volte efficace. Ad esempio, un ScrollBar verrà IsEnabledfalse ogni volta che viene determinato che non è necessario supportare una barra di scorrimento. Anche il tentativo di impostare questo valore verrà potenzialmente sottoposto a override dal valore restituito da IsEnabledCore.

Gli elementi non abilitati non partecipano al hit testing o allo stato attivo e pertanto non saranno origini di eventi di input.

Informazioni sulle proprietà di dipendenza

Campo Identificatore	IsEnabledProperty
Proprietà dei metadati impostate su true	Nessuno

Vedi anche

• IsEnabledChanged