UIElement.Visibility 속성

정의

네임스페이스:

Windows.UI.Xaml

.의 UIElement표시 유형을 가져오거나 설정합니다. 표시되지 않는 A UIElement 는 렌더링되지 않으며 원하는 크기를 레이아웃에 전달하지 않습니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.UIElement.Visibility(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public:
 property Visibility Visibility { Visibility get(); void set(Visibility value); };

Visibility Visibility();

void Visibility(Visibility value);

public Visibility Visibility { get; set; }

var visibility = uIElement.visibility;
uIElement.visibility = visibility;

Public Property Visibility As Visibility

<uiElement Visibility="Visible"/>
-or-
<uiElement Visibility="Collapsed"/>

속성 값

Visibility

열거형 값입니다. 기본값은 Visible 입니다.

예제

시각적 상태의 표시 여부 컨트롤에 대한 시각적 상태를 정의하는 과정의 일부로 개체의 표시 유형 상태를 Collapsed 로 변경하려는 경우가 있습니다. 시각적 상태는 애니메이션을 사용합니다. Visibility의 속성 값 형식은 열거형입니다 Visibility. 열거형 DiscreteObjectKeyFrame값에 애니메이션 효과를 주려면 . 부울 값에도 이 기술을 사용합니다. 이 XAML 예제에서는 표시 유형을 변경하는 데 사용하는 DiscreteObjectKeyFrame 시각적 상태를 보여 주는 예제입니다.

<VisualState x:Name="Focused">
  <Storyboard>
    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="FocusVisualElement" Storyboard.TargetProperty="Visibility" Duration="0">
      <DiscreteObjectKeyFrame KeyTime="0" Value="Visible"/>
    </ObjectAnimationUsingKeyFrames>
  </Storyboard>
</VisualState>

설명

Visibility가 Collapsed 와 같은 UI 요소는 페이지의 나머지 XAML과 함께 로드되고 런타임 개체 트리에 존재합니다.

Visibility가 Collapsed 인 요소는 UI에 위치가 없으며 입력 또는 적중 테스트에 참여하지 않습니다. 또한 탭 시퀀스에 있지 않으며 프로그래밍 방식으로도 집중할 수 없습니다. 표시 유형을 설정하는 대신 입력, 포커스 또는 적중 테스트를 계속하려면 0 Opacity을 사용합니다.

BooleanToVisibilityConverter

데이터 원본의 데이터를 사용하는 앱의 일반적인 시나리오는 데이터의 속성 또는 데이터가 표시되어야 하는지 여부를 제어하는 데이터의 뷰 모델을 식별하는 것입니다. 관련 시나리오는 부모 컨트롤 또는 다른 파트의 부울 속성을 기반으로 컨트롤 파트의 표시 유형을 변경할 수 있는 템플릿을 작성하는 것입니다. 이 동작 Binding을 더 쉽게 정의할 수 있도록 일부 기본 프로젝트 템플릿에는 Common 폴더에 BooleanToVisibilityConverter 도우미 클래스가 포함됩니다. 데이터 바인딩에 값 변환기를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요 IValueConverter.

추가 정보

• XAML을 사용하여 레이아웃 정의