uap:VisualElements(Windows 10)

아티클
10/30/2023

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

요소 계층 구조

<uap:VisualElements>

Syntax

<uap:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    Square44x44Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    AppListEntry = 'An optional string that can have one of the following values: "default" or "none".' >

  <!-- Child elements -->
  uap:DefaultTile?
  & uap:LockScreen?
  & uap:SplashScreen?
  & uap:InitialRotationPreference?

</uap:VisualElements>

키

? 선택적(0개 또는 1개) & 인터리브 커넥터(임의의 순서로 발생할 수 있음)

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
표시 이름	사용자에게 표시할 수 있는 앱의 이름입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 설명을 참조하세요 .	값이 1~256자인 문자열입니다. 이 문자열은 지역화할 수 있습니다.	예
설명	앱에 대한 설명입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 설명을 참조하세요 .	1~2048자 사이의 문자열입니다.	Yes
BackgroundColor	앱 타일의 배경색을 지정합니다. 색 이름은 설명 섹션을 참조하세요.		Yes
Square150x150Logo	앱의 시작 화면 중간 타일 및 작업 전환기에서 사용되는 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.	, 또는 문자를 포함`>?"*\|:<`할 수 없는 , `.png`또는 로 `.jpg`끝나는 길이가 1자에서 256자 사이의 문자열입니다.`.jpeg` 이 문자열에서 및 `\` 문자는 `/` 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열에는 둘 다 포함하거나 `\` 포함할 수는 없지만 둘 다 포함될 `/` 수는 없습니다.	Yes
Square44x44Logo	앱의 시작 화면 작은 타일 및 모든 앱 목록에서 사용되는 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요.	, 또는 문자를 포함`>?"*\|:<`할 수 없는 , `.png`또는 로 `.jpg`끝나는 길이가 1자에서 256자 사이의 문자열입니다.`.jpeg` 이 문자열에서 및 `\` 문자는 `/` 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열에는 둘 다 포함하거나 `\` 포함할 수는 없지만 둘 다 포함될 `/` 수는 없습니다.	Yes
AppListEntry	모든 앱 목록의 항목입니다. 시작 메뉴 타일이 필요하지 않은 진입점에 대해 없음을 선택합니다.	"default" 또는 "none" 값 중 하나를 가질 수 있는 선택적 문자열입니다.	No	default

참고

여기에 지정된 배경색은 다음 항목에도 적용됩니다.

앱 소유 대화 상자의 단추 색
스토어의 앱 설명 페이지

자식 요소

자식 요소	Description
uap:DefaultTile	시작 화면의 앱을 나타내는 기본 타일입니다. 이 타일은 앱이 처음 설치될 때 업데이트 알림을 받기 전에 표시됩니다. 타일에 표시할 알림이 없으면 타일이 이 기본값으로 되돌아갑니다.
uap:InitialRotationPreference	최상의 사용자 환경을 위해 앱이 표시되기를 원하는 방향을 설명합니다. 태블릿과 같이 회전할 수 있는 디바이스에서는 여기에 지정되지 않은 방향에 대해 앱이 다시 그려지지 않습니다. instance 경우 앱이 및 `LandscapeFlipped` 방향만 `Landscape` 지정하고 디바이스가 방향으로 회전 `Portrait` 하면 앱이 회전하지 않습니다.
uap:LockScreen	시스템이 잠겨 있을 때 표시되는 잠금 화면의 앱을 나타내는 배지 및 알림을 정의합니다.
uap:SplashScreen	시작 중에 앱에서 표시하는 시작 화면의 모양을 정의합니다.

참고

회전할 수 없는 디바이스에서는 해당 디바이스의 기본 방향에 앱이 표시될 수 있으며 앱의 기본 방향은 무시됩니다. 그러나 회전 잠금이 활성화된 디바이스에서는 앱의 기본 설정 회전이 계속 적용됩니다.

이러한 방향 기본 설정 선택은 앱에 대한 새 세션이 시작될 때 시작 화면 과 앱 UI 모두에 적용됩니다. AutoRotationPreferences 속성을 통해 런타임 중에 기본 설정을 변경할 수 있습니다.

부모 요소

부모 요소	설명
애플리케이션	패키지에 제공된 기능의 일부 또는 전부로 구성된 앱을 나타냅니다.

설명

타일 차원 요구 사항에 대한 자세한 내용은 타일 크기를 참조하세요.

Square150x150Logo 및 Square44x44Logo 이미지의 경우 Windows에서 디바이스 및 화면 해상도에 가장 적합한 크기를 선택할 수 있도록 다양한 눈금의 이미지를 제공할 수 있습니다. 접근성을 위한 고대비 이미지와 다양한 UI 언어와 일치하도록 지역화된 이미지를 제공할 수도 있습니다. 이 기능을 사용하면 DisplayName 및 Description 특성을 지역화할 수도 있습니다 . 자세한 내용은 세계화 항목을 참조하세요.

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

두 가지 유형의 로고 이미지에 대한 크기 요구 사항은 다음과 같습니다.

이미지 특성	크기 조정(이미지 크기(픽셀)
`Applications/Application/VisualElements/@Square150x150Logo`	100(150x150)
	250(375x375)
`Applications/Application/VisualElements/@Square44x44Logo`	100(44x44)
	250(110x110)
`Applications/Application/VisualElements/@Tall150x310Logo`	100(150x310)
	250(375x775)

지원되는 배경색 이름은 다음과 같습니다.

aliceBlue
antiqueWhite
aqua
aquamarine
azure
beige
bisque
black
blanchedAlmond
blue
blueViolet
brown
burlyWood
cadetBlue
chartreuse
chocolate
coral
콘플라워블루
cornsilk
crimson
cyan
darkBlue
darkCyan
darkGoldenrod

darkGray
darkGreen
darkKhaki
darkMagenta
darkOliveGreen
darkOrange
darkOrchid
darkRed
darkSalmon
darkSeaGreen
darkSlateBlue
darkSlateGray
darkTurquoise
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
firebrick
floralWhite
forestGreen
fuchsia
gainsboro
ghostWhite

gold
goldenrod
gray
green
greenYellow
honeydew
hotPink
indianRed
indigo
ivory
khaki
lavender
lavenderBlush
lawnGreen
lemonChiffon
lightBlue
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
lightPink
lightSalmon
lightSeaGreen

lightSkyBlue
lightSlateGray
lightSteelBlue
lightYellow
lime
limeGreen
linen
magenta
maroon
mediumAquamarine
mediumBlue
mediumOrchid
mediumPurple
mediumSeaGreen
mediumSlateBlue
mediumSpringGreen
mediumTurquoise
mediumVioletRed
midnightBlue
mintCream
mistyRose
moccasin
navajoWhite

navy
oldLace
olive
oliveDrab
orange
orangeRed
orchid
paleGoldenrod
paleGreen
paleTurquoise
paleVioletRed
papayaWhip
peachPuff
peru
pink
plum
powderBlue
purple
red
rosyBrown
royalBlue
saddleBrown
salmon

sandyBrown
seaGreen
조개
sienna
silver
skyBlue
slateBlue
slateGray
snow
springGreen
steelBlue
tan
teal
thistle
tomato
transparent
turquoise
violet
wheat
white
Whitesmoke
yellow
yellowGreen

예제

다음 예제는 SDK 샘플의 패키지 매니페스트에서 가져옵니다.

<Applications>
    <Application Id="App" StartPage="default.html">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile
                ShowName="allLogos" />
            <uap:LockScreen
                Notification="badge"
                BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen
                BackgroundColor="white"
                Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation
                    Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>

추가 정보

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 버전 1511(빌드 10586)

다음을 통해 공유