UIElement.IsEnabled Propriété

Définition

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é

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, lors de l’exécution, définit IsEnabledfalse sur un autre bouton nommé 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

Remarques

Notez que cette propriété est influencée par des implémentations spécifiques à la classe de IsEnabledCore sur des éléments particuliers, souvent au moment de 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 IsEnabledfalse 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 au test 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

S’applique à

Voir aussi