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

Definizione

Ottiene o imposta un valore che indica se questo elemento è abilitato in interfaccia utenteuser interface (UI).Gets or sets a value indicating whether this element is enabled in the interfaccia utenteuser interface (UI). Si tratta di una proprietà di dipendenza.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

Valore della proprietà

true se l'elemento è abilitato; in caso contrario false.true if the element is enabled; otherwise, false. Il valore predefinito è true.The default value is true.

Esempi

Nell'esempio seguente viene illustrato un gestore in un pulsante che, se eseguito IsEnabled , viene impostato false su b1un altro pulsante denominato.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

Commenti

Si noti che questa proprietà è influenzata dalle implementazioni specifiche della IsEnabledCore classe di su particolari elementi, spesso in fase di esecuzione.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. Pertanto, il valore predefinito elencato qui non è a volte valido.Therefore, the default value listed here is sometimes not effective. Ad esempio, un ScrollBar IsEnabled sarà ogni volta che viene determinata la necessità di supportare una barra di scorrimento. falseFor instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. Il tentativo di impostare questo valore verrà inoltre potenzialmente sostituito dal valore restituito da IsEnabledCore.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

Gli elementi non abilitati non partecipano all'hit testing o allo stato attivo e pertanto non saranno origini di eventi di input.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field IsEnabledProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Si applica a

Vedi anche