UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled UIElement.IsEnabled Property

Définition

Obtient ou définit une valeur indiquant si cet élément est activé dans l’élément interface utilisateur (UI)user interface (UI).Gets or sets a value indicating whether this element is enabled in the interface utilisateur (UI)user interface (UI). Il s’agit d’une propriété de dépendance.This is a dependency property.

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.true if the element is enabled; otherwise, false. La valeur par défaut est true.The default value is true.

Exemples

L’exemple suivant montre un gestionnaire sur un bouton que lorsque la valeur sera exécutée IsEnabled false sur un autre bouton nommé b1.The following example shows a handler on one button that when executed will set IsEnabled false on another named button 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 les implémentations spécifiques à la classe de IsEnabledCore sur des éléments particuliers, souvent lors de l’exécution.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Par conséquent, la valeur par défaut répertoriée ici n’est parfois pas efficace.Therefore, the default value listed here is sometimes not effective. Par exemple, un ScrollBar sera IsEnabled false chaque fois qu’il est déterminé qu’il n’est pas nécessaire pour prendre en charge d’une barre de défilement.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Tentative de définition de cette valeur sera également potentiellement remplacée par la valeur retournée par IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Les éléments qui ne sont pas activés ne participent pas le test de positionnement ou le focus et par conséquent ne sera pas sources d’événements d’entrée.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field IsEnabledProperty
La valeur des propriétés de métadonnées trueMetadata properties set to true Aucun.None

S’applique à

Voir aussi