UIElement.Visibility Property


이 요소의 UI(사용자 인터페이스)user interface (UI) 표시 유형을 가져오거나 설정합니다.Gets or sets the UI(사용자 인터페이스)user interface (UI) visibility of this element. 이 속성은 종속성 속성입니다.This is a dependency property.

 property System::Windows::Visibility Visibility { System::Windows::Visibility get(); void set(System::Windows::Visibility value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public System.Windows.Visibility Visibility { get; set; }
member this.Visibility : System.Windows.Visibility with get, set
Public Property Visibility As Visibility

Property Value


열거형 값입니다.A value of the enumeration. 기본값은 Visible입니다.The default value is Visible.



다음 예제에서는 사용자 인터페이스의 쌍으로 함께 수 있는 두 개의 명명 된 단추를 참조 하는 처리기를 구현 합니다.The following example implements a handler that references two different named buttons that are intended to be a mutually exclusive pair in the user interface. 단추와 연결 된 실제 프로그램 논리를 실행 하기 전에는 단추 자체가 Visibility.Hidden로 설정 되 고 쌍의 다른 단추가 Visibility.Visible로 설정 됩니다.Prior to running the actual program logic associated with the button, the button itself is set to be Visibility.Hidden, and the other button in the pair is set to Visibility.Visible.

private void PlayMedia(object sender, MouseButtonEventArgs args)
    pauseBTN.Visibility = Visibility.Visible;
    playBTN.Visibility = Visibility.Collapsed;

    media.SpeedRatio = 1.0;
Private Sub PlayMedia(ByVal sender As Object, ByVal args As MouseButtonEventArgs)
    pauseBTN.Visibility = System.Windows.Visibility.Visible
    playBTN.Visibility = System.Windows.Visibility.Collapsed

    media.SpeedRatio = 1.0

End Sub


이 속성을 설정 하면 IsVisible값에 영향을 주므로 IsVisibleChanged 이벤트를 발생 시킬 수 있습니다.Setting this property affects the value of IsVisible, which in turn may raise the IsVisibleChanged event. 그러나 IsVisible에는이에 영향을 주는 다른 요인이 있습니다. 예를 들어이를 포함 하는 부모의 표시 유형 설정도 있습니다.However, IsVisible has other factors that influence it, for instance the visibility settings of parents that contain it.

Visibility Visible 되지 않는 요소는 입력 이벤트 (또는 명령)에 참여 하지 않습니다. 레이아웃의 측정 또는 정렬 단계에는 영향을 주지 않습니다. 즉, 탭 시퀀스에 있지 않으며 적중 테스트에서 보고 되지 않습니다.Elements where Visibility is not Visible do not participate in input events (or commands), do not influence either the Measure or Arrange passes of layout, are not in a tab sequence, and will not be reported in hit testing.

Window 또는 파생 클래스에서 상속 되는 경우이 속성의 기본값을 CollapsedWindow 다시 정의 합니다.When inherited by Window or its derived classes, Window redefines the default value of this property to be Collapsed. 이는 처음에 만든 Window레이아웃의 측정 단계를 실행 하지 않고 RenderSize (0, 0)을 반환 하는 효과를 가집니다.This has the effect of not running the Measure pass of layout on an initially created Window, and RenderSize returns (0,0). 자세한 내용은 Window을 참조하세요.For details, see Window. 또한 PopupPopup 및 해당 파생 클래스에 대해 유사한 결과를 사용 하 여 Collapsed되도록 기본값을 다시 정의 합니다.Popup also redefines the default value to be Collapsed, with similar resulting behavior for Popup and its derived classes.

종속성 속성 정보Dependency Property Information

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

Applies to

See also