다음을 통해 공유


Expander 클래스

정의

헤더를 표시하고 콘텐츠를 표시하는 축소 가능한 본문이 있는 컨트롤을 나타냅니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.Experimental]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class Expander : ContentControl
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class Expander : ContentControl
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.Experimental]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class Expander : ContentControl
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class Expander : ContentControl
Public Class Expander
Inherits ContentControl
상속
Expander
특성

예제

자세한 정보, 디자인 지침 및 코드 예제는 Expander를 참조하세요.

WinUI 2 갤러리 앱에는 대부분의 WinUI 2 컨트롤, 특징, 기능의 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub에서 소스 코드를 가져오세요.

설명

자세한 내용, 디자인 지침 및 코드 예제는 Expander 개요를 참조하세요.

Expander 를 사용하여 표시 공간이 제한될 때 가장 중요한 콘텐츠에 집중합니다. 컨트롤을 Expander 사용하면 항상 표시되는 기본 콘텐츠 조각과 관련된 덜 중요한 콘텐츠를 표시하거나 숨길 수 있습니다. Header에 포함된 항목은 항상 표시됩니다. 사용자는 헤더와 상호 작용하여 보조 콘텐츠가 표시되는 콘텐츠 영역을 확장하고 축소할 수 있습니다. 확장된 콘텐츠 영역은 다른 UI와 겹치지 않고 다른 UI 요소를 밀어냅니다. Expander는 위쪽 또는 아래쪽으로 확장할 수 있습니다.

HeaderContent 영역 둘 다 간단한 텍스트부터 복잡한 UI 레이아웃까지 모든 콘텐츠를 포함할 수 있습니다.

컨트롤 스타일 및 템플릿

기본 스타일ControlTemplate 을 수정하여 컨트롤에 고유한 모양을 지정할 수 있습니다. 컨트롤의 스타일 및 템플릿을 수정하는 방법에 대한 자세한 내용은 XAML 스타일을 참조하세요. 컨트롤의 모양을 정의하는 기본 스타일, 템플릿 및 리소스가 파일에 포함 generic.xaml 됩니다. 디자인 목적으로 는 generic.xaml WinUI(Microsoft.UI.Xaml) NuGet 패키지와 함께 설치됩니다. 기본적으로 이 위치는 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml입니다. 다른 버전의 WinUI의 스타일 및 리소스에는 다른 값이 있을 수 있습니다.

XAML에는 컨트롤 템플릿을 수정하지 않고 다른 시각적 상태에서 컨트롤의 색을 수정하는 데 사용할 수 있는 리소스도 포함되어 있습니다. 이러한 리소스를 수정하는 것은 BackgroundForeground와 같은 속성을 설정하는 것이 좋습니다. 자세한 내용은 XAML 스타일 문서의 경량 스타일 섹션을 참조하세요.

생성자

Expander()

Expander 클래스의 새 instance 초기화합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

속성

ExpandDirection

콘텐츠 영역이 확장되는 방향을 나타내는 값을 가져오거나 설정합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

ExpandDirectionProperty

ExpandDirection 종속성 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

Header

Expander의 헤더에 표시되는 XAML 콘텐츠를 가져오거나 설정합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HeaderProperty

Header 종속성 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HeaderTemplate

Expander.Header에 대한 데이터 템플릿을 가져오거나 설정합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HeaderTemplateProperty

HeaderTemplate 종속성 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HeaderTemplateSelector

헤더에 적용할 템플릿을 반환하는 사용자 지정 DataTemplateSelector 논리 클래스에 대한 참조를 가져오거나 설정합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

HeaderTemplateSelectorProperty

HeaderTemplateSelector 종속성 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

IsExpanded

Expander의 콘텐츠 영역이 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

IsExpandedProperty

IsExpanded 종속성 속성을 식별합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

TemplateSettings

Expander에 대한 템플릿을 정의할 때 TemplatedParent 원본으로 참조할 수 있는 계산 값을 제공하는 개체를 가져옵니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

이벤트

Collapsed

Expander의 콘텐츠 영역을 숨길 때 발생합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

Expanding

Expander의 콘텐츠 영역이 표시되기 시작할 때 발생합니다.

이 설명서는 UWP용 WinUI 2에 적용됩니다(Windows 앱 SDKWinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

적용 대상

추가 정보