다음을 통해 공유


UIElement.Visibility 속성

정의

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

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"/>

속성 값

열거형 값입니다. 기본값은 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입니다.

BooleanToVisibilityConverter

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

적용 대상

추가 정보