VisualElements(Windows 8.1 기능 확장 스키마)

아티클
07/20/2023

UWP 앱의 시각적 측면을 설명합니다. 기본 타일, 로고 이미지, 텍스트 및 배경색, 초기 화면 방향, 시작 화면 및 잠금 화면 타일 모양.

요소 계층 구조

<VisualElements>

Syntax

<VisualElements Square150x150Logo = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                Square30x30Logo   = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  & ApplicationView?
  )

</VisualElements>

키

? 선택 사항(0 또는 1)

& 인터리브 커넥터(임의의 순서로 발생할 수 있음)

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
Square150x150Logo	앱의 사각형 타일로 사용되는 150x150 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.	".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1~256자인 문자열로, \| 다음 >문자를 <포함할 수 없습니다. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다.	예
Square30x30Logo	앱의 사각형 타일로 사용되는 30x30 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.	".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1~256자인 문자열로, \| 다음 >문자를 <포함할 수 없습니다. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다.	예

자식 요소

자식 요소	Description
ApplicationView	화면에서 앱을 보는 방법을 설명합니다.
DefaultTile	시작 화면의 앱을 나타내는 기본 타일입니다. 이 타일은 앱이 처음 설치될 때 업데이트 알림을 받기 전에 표시됩니다. 타일에 표시할 알림이 없으면 타일이 이 기본값으로 돌아갑니다.
InitialRotationPreference	최상의 사용자 환경을 위해 앱이 표시되는 방향을 설명합니다. 태블릿과 같이 회전할 수 있는 디바이스에서는 여기에 지정되지 않은 방향에 대해 앱을 다시 그려지지 않습니다. 예를 들어 앱이 가로 방향 및 LandscapeFlipped 방향만 지정하고 디바이스가 세로 방향으로 회전되는 경우 앱은 회전하지 않습니다. 회전할 수 없는 디바이스에서는 해당 디바이스의 기본 방향에 앱이 표시될 수 있으며 앱의 기본 방향은 무시됩니다. 그러나 회전 잠금이 활성화된 디바이스에서는 앱에서 선호하는 회전이 계속 적용됩니다. 이러한 방향 기본 설정 선택은 앱에 대한 새 세션이 시작될 때 [시작 화면](element-splashscreen.md) 및 앱 UI 모두에 적용됩니다. 런타임에 [AutoRotationPreferences](/uwp/api/Windows 통해 기본 설정을 변경할 수 있습니다. Graphics.Display.DisplayInformation) 속성입니다.
LockScreen	시스템이 잠겨 있을 때 표시되는 잠금 화면에서 앱을 나타내는 배지 및 알림을 정의합니다.
SplashScreen	시작 화면의 모양을 정의합니다. 시작 화면은 시작 중에 앱에서 표시합니다.

부모 요소

이 가장 바깥쪽(문서) 요소는 다른 요소에 포함되지 않을 수 있습니다.

설명

앱의 시각적 측면에 대한 자세한 내용은 VisualElements를 참조하세요.

매니페스트는 스키마에 적용되지 않는 VisualElements에 대해 이러한 의미 체계 검사를 수행합니다.

DefaultTile\Square310x310Logo를 지정한 경우 DefaultTile\Wide310x150Logo도 지정해야 합니다.
DefaultTile\DefaultSize 또는 ShowNameOnTiles가 특정 이미지 크기 값을 지정하는 경우 해당 이미지 크기는 매니페스트에 선언되어 있어야 합니다.
LockScreen\Notification이 badgeAndTileText로 설정된 경우 DefaultTile\Wide310x150Logo를 지정해야 합니다.

Square150x150Logo 및 Square30x30Logo 이미지는 이미지 파일의 직접 경로 또는 리소스로 제공될 수 있습니다. 리소스 참조를 사용하여 다양한 UI 언어와 일치하도록 지역화된 이미지를 제공할 수 있습니다. 자세한 내용은 세계화 항목을 참조하세요.

요구 사항

	값
Namespace	`http://schemas.microsoft.com/appx/2013/manifest`

다음을 통해 공유