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, verrà impostato IsEnabled false su un altro pulsante b1denominato .

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 su determinati elementi, spesso in fase di IsEnabledCore esecuzione. Pertanto, il valore predefinito elencato di seguito non è a volte efficace. Ad esempio, un ScrollBar oggetto sarà IsEnabled false ogni volta che viene determinato che non è necessario supportare una barra di scorrimento. Anche il tentativo di impostare questo valore verrà sottoposto a override dal valore restituito da IsEnabledCore.

Gli elementi che non sono abilitati non partecipano a hit test o messa a fuoco e pertanto non saranno origini di eventi di input.

Informazioni proprietà di dipendenza

Campo Identificatore	IsEnabledProperty
Proprietà dei metadati impostate su true	Nessuno

Vedi anche

• IsEnabledChanged