UIElement.IsEnabled 속성

정의

이 요소를 UI(사용자 인터페이스)user interface (UI)에서 사용할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether this element is enabled in the UI(사용자 인터페이스)user interface (UI). 이 속성은 종속성 속성입니다.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

속성 값

요소를 사용하면 true이고, 그렇지 않으면 false입니다.true if the element is enabled; otherwise, false. 기본값은 true입니다.The default value is true.

예제

다음 예제에서는 실행 될 때 명명 된 다른 단추 b1false IsEnabled 설정 하는 한 가지 단추에 대 한 처리기를 보여 줍니다.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

설명

이 속성은 종종 런타임에 특정 요소에 대 한 IsEnabledCore의 클래스 별 구현에 영향을 받습니다.Note that this property is influenced by class-specific implementations of IsEnabledCore on particular elements, often at runtime. 따라서 여기에 나열 된 기본값은 유효 하지 않을 수 있습니다.Therefore, the default value listed here is sometimes not effective. 예를 들어 ScrollBar는 스크롤 막대를 지원할 필요가 없는 것으로 확인 될 때마다 false IsEnabled 됩니다.For instance, a ScrollBar will be IsEnabled false whenever it is determined that there is no need to support a scrollbar. 이 값을 설정 하는 것은 IsEnabledCore에서 반환 된 값에 의해 재정의 될 수도 있습니다.Attempting to set this value will also potentially be overridden by the value returned by IsEnabledCore.

사용할 수 없는 요소는 적중 테스트 또는 포커스에 참여 하지 않으므로 입력 이벤트의 소스가 되지 않습니다.Elements that are not enabled do not participate in hit testing or focus and therefore will not be sources of input events.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field IsEnabledProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보