UIElement.IsEnabled Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Obtient ou définit une valeur indiquant si cet élément est activé dans l’interface utilisateur. Il s’agit d’une propriété de dépendance.

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

Valeur de propriété

Boolean

true si l’élément est activé ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple suivant montre un gestionnaire sur un bouton qui, lorsqu’il est exécuté, est défini IsEnabled false sur un autre bouton b1nommé.

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

Remarques

Notez que cette propriété est influencée par des implémentations spécifiques à la classe d’éléments particuliers, souvent au moment de IsEnabledCore l’exécution. Par conséquent, la valeur par défaut répertoriée ici n’est parfois pas effective. Par exemple, un ScrollBar sera IsEnabled false chaque fois qu’il est déterminé qu’il n’est pas nécessaire de prendre en charge une barre de défilement. Toute tentative de définition de cette valeur peut également être remplacée par la valeur retournée par IsEnabledCore.

Les éléments qui ne sont pas activés ne participent pas aux tests de positionnement ou au focus et ne seront donc pas des sources d’événements d’entrée.

Informations sur les propriétés de dépendance

Champ d’identificateur	IsEnabledProperty
Propriétés de métadonnées définies sur true	Aucun

Voir aussi

• IsEnabledChanged