ApplicationView 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
활성 애플리케이션 보기 및 연결된 상태 및 동작을 나타냅니다.
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 ApplicationViewPublic NotInheritable Class ApplicationView- 상속
- 특성
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 값이 변경될 때 발생합니다. |