ApplicationView 클래스

정의

네임스페이스:

Windows.UI.ViewManagement

활성 애플리케이션 보기 및 연결된 상태 및 동작을 나타냅니다.

public ref class ApplicationView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ApplicationView

Public NotInheritable Class ApplicationView

상속

Object Platform::Object IInspectable ApplicationView

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

창(앱 보기라고도 함)은 Windows 런타임 앱의 표시된 부분입니다. Windows에서 사용자의 화면에는 최대 4개 창의 가변 너비가 동시에 표시될 수 있습니다. 겹치지 않으며 위쪽 및 아래쪽 가장자리가 화면의 위쪽 및 아래쪽 가장자리에 닿습니다. 인접한 창 사이에 창이 아닌 영역이 있을 수 있습니다.

창은 애플리케이션의 현재 페이지와 동일하지 않습니다. 페이지의 컨테이너로 더 잘 생각됩니다. 애플리케이션의 모든 페이지에 대해 프로그램에서 창 참조를 사용할 수 있습니다.

각 창에는 창에 대한 UI 처리 스레드(핵심 입력 처리기 및 이벤트 디스패처 포함)를 나타내는 해당 CoreWindow 가 있습니다.

페이지 구성에서 창의 속성(또는 JavaScript의 경우 메서드)을 사용할 수 있습니다. 예를 들어 Orientation 속성은 창이 세로인지 가로인지 여부를 알려줍니다. Windows의 경우 AdjacentToLeftDisplayEdge 속성은 화면의 왼쪽 가장자리가 창의 왼쪽 테두리인지 여부를 알려줍니다. 및 isFullScreen 메서드는 창이 전체 화면을 사용하는지 여부를 알려줍니다. 이러한 메서드를 사용하는 예제는 애플리케이션 뷰 샘플을 참조하세요.

이 형식의 개체를 가져오려면 ApplicationView.GetForCurrentView를 호출합니다.

참고

페이지 레이아웃을 만들 때 ApplicationView.Value 속성에 반환된 값을 사용하지 마세요. 이 메서드는 더 이상 사용되지 않으며 이후 릴리스에서는 사용할 수 없습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	IsViewModeSupported
1703	15063	TryConsolidateAsync
1703	15063	TryEnterViewModeAsync(ApplicationViewMode)
1703	15063	TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
1703	15063	ViewMode
1903	18362	ClearAllPersistedState
1903	18362	ClearPersistedState
1903	18362	GetDisplayRegions
1903	18362	PersistedStateId
1903	18362	UIContext
1903	18362	WindowingEnvironment

속성

AdjacentToLeftDisplayEdge	현재 창이 화면의 왼쪽 가장자리에 가까운지 여부를 나타내는 값을 가져옵니다.
AdjacentToRightDisplayEdge	현재 창이 화면의 오른쪽 가장자리에 가까운지 여부를 나타내는 값을 가져옵니다.
DesiredBoundsMode	프레임워크에서 창(앱 보기)의 내용을 배치하는 데 사용하는 범위를 나타내는 값을 가져옵니다.
FullScreenSystemOverlayMode	전체 화면 모드의 앱이 에지 살짝 밀기 작업에 응답하는 방법을 나타내는 값을 가져오거나 설정합니다.
Id	창의 ID(앱 보기)를 가져옵니다.
IsFullScreen	참고 IsFullScreen은 Windows 10 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 IsFullScreenMode를 사용합니다. 창이 디스플레이의 왼쪽과 오른쪽에 모두 닿는지 여부를 나타내는 값을 가져옵니다.
IsFullScreenMode	앱이 전체 화면 모드에서 실행 중인지 여부를 나타내는 값을 가져옵니다.
IsOnLockScreen	창(앱 보기)이 Windows 잠금 화면에 있는지 여부를 가져옵니다.
IsScreenCaptureEnabled	창(앱 보기)에 대해 화면 캡처를 사용할 수 있는지 여부를 가져오거나 설정합니다.
Orientation	디스플레이와 관련된 창(앱 보기)의 현재 방향(가로 또는 세로)을 가져옵니다.
PersistedStateId	상태를 추적하고 저장하기 위해 이 뷰를 식별하는 문자열을 가져오거나 설정합니다.
PreferredLaunchViewSize	시스템에서 창 크기를 직접 관리하는 경우를 제외하고 ApplicationView.PreferredLaunchWindowingMode 속성이 PreferredLaunchViewSize로 설정된 경우 앱이 시작하는 크기를 가져오거나 설정합니다.
PreferredLaunchWindowingMode	앱이 시작하는 창 모드를 나타내는 값을 가져오거나 설정합니다.
SuppressSystemOverlays	참고 SuppressSystemOverlays는 Windows 10 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 TryEnterFullScreenMode 및 FullScreenSystemOverlayMode를 사용합니다. 시스템 오버레이(예: 오버레이 애플리케이션 또는 소프트 스티어링 휠)를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.
TerminateAppOnFinalViewClose	마지막 창이 닫혔을 때 앱이 종료되는지 여부를 나타냅니다.
Title	창의 표시된 제목을 가져오거나 설정합니다.
TitleBar	앱의 제목 표시줄을 가져옵니다.
UIContext	뷰에 대한 컨텍스트 식별자를 가져옵니다.
Value	참고 ApplicationView 정적 메서드는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 ApplicationView.GetForCurrentView 를 사용하여 ApplicationView 개체를 가져옵니다. 현재 창의 상태(앱 보기)를 가져옵니다.
ViewMode	현재 보기에 대한 앱 보기 모드를 가져옵니다.
VisibleBounds	창의 표시되는 영역(앱 보기)을 가져옵니다. 표시되는 영역은 상태 막대 및 앱 바와 같은 chrome에 의해 가려지지 않은 영역입니다.
WindowingEnvironment	보기에 대한 창 환경을 가져옵니다.

메서드

ClearAllPersistedState()	지정된 애플리케이션에 대한 모든 보기 PersistedStateId에 대해 시스템이 저장한 속성을 지웁니다.
ClearPersistedState(String)	지정된 애플리케이션에 대해 지정된 식별자를 사용하여 시스템에서 뷰에 대해 저장한 속성을 지웁니다.
ExitFullScreenMode()	앱을 전체 화면 모드에서 해제합니다.
GetApplicationViewIdForWindow(ICoreWindow)	앱에서 관리하는 특정 CoreWindow 에 해당하는 창 ID를 가져옵니다.
GetDisplayRegions()	보기에 사용할 수 있는 표시 영역의 컬렉션을 반환합니다.
GetForCurrentView()	활성 애플리케이션의 보기 상태 및 동작 설정을 가져옵니다.
IsViewModeSupported(ApplicationViewMode)	지정된 보기 모드가 현재 디바이스에서 지원되는지 여부를 결정합니다.
SetDesiredBoundsMode(ApplicationViewBoundsMode)	프레임워크에서 창의 내용(앱 보기)을 배치하는 데 사용하는 범위를 나타내는 값을 설정합니다.
SetPreferredMinSize(Size)	앱 창에 허용되는 가장 작은 크기(유효 픽셀)를 설정합니다.
ShowStandardSystemOverlays()	전체 화면 앱을 통해 제목 표시줄과 같은 시스템 UI 요소를 표시합니다.
TryConsolidateAsync()	현재 앱 보기를 숨기려고 시도합니다. 이 메서드는 앱을 닫는 사용자와 동일한 프로그래밍 방식입니다.
TryEnterFullScreenMode()	앱을 전체 화면 모드로 배치하려고 시도합니다.
TryEnterViewModeAsync(ApplicationViewMode)	앱 보기를 지정된 보기 모드로 변경하려고 시도합니다.
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	지정된 옵션을 사용하여 앱 보기를 지정된 보기 모드로 변경하려고 시도합니다.
TryResizeView(Size)	보기의 크기를 유효 픽셀의 지정된 크기로 변경하려고 시도합니다.
TryUnsnap()	참고 TryUnsnap은 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없을 수 있습니다. 앱의 크기를 지속적으로 조정할 수 있지만 Windows 8.1 시작하여 스냅할 수는 없습니다. 또한 ApplicationView 정적 메서드는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없을 수 있습니다. ApplicationView.GetForCurrentView를 사용하여 ApplicationView 개체를 가져옵니다. 이전에 스냅된 앱을 제거하려고 시도합니다. 이 호출은 앱이 포그라운드에서 실행되는 경우에만 성공합니다.
TryUnsnapToFullscreen()	이전에 스냅된 앱을 제거하려고 시도합니다.

이벤트

Consolidated	최근에 사용한 앱 목록에서 창이 제거되거나 사용자가 닫기 제스처를 실행할 때 발생합니다.
VisibleBoundsChanged	이 이벤트는 일반적으로 상태 막대, 앱 바 또는 기타 크롬이 표시되거나 숨겨져 있기 때문에 VisibleBounds 값이 변경될 때 발생합니다.

추가 정보

• 화면 캡처 샘플 사용 안 됨(Windows 10)
• 사용자 상호 작용 모드 샘플(Windows 10)
• 여러 보기 샘플(Windows 10)
• 전체 화면 모드 샘플(Windows 10)
• 창 크기 조정 샘플(Windows 10)
• 제목 표시줄 샘플(Windows 10)