VisualElements(Windows 8.1 대한 확장 스키마)
UWP 앱의 시각적 측면을 설명합니다. 기본 타일, 로고 이미지, 텍스트 및 배경색, 초기 화면 방향, 시작 화면 및 잠금 화면 타일 모양.
요소 계층 구조
<VisualElements>
Syntax
<VisualElements DisplayName = A string between 1 and 256 characters in length. This string is localizable.
Description = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
ForegroundText = "light" | "dark"
BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
ToastCapable? = boolean
Logo = 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.
SmallLogo = 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?
)
</VisualElements>
키
? 선택 사항(0개 또는 1개)
& 인터리브 커넥터(어떤 순서로든 발생할 수 있음)
특성 및 요소
특성
| attribute | Description | 데이터 형식 | 필수 | 기본값 |
|---|---|---|---|---|
| BackgroundColor | 앱 타일의 배경색을 지정합니다. 색 이름은 주의 섹션을 참조하세요. 여기에 지정된 배경색은 다음 항목에도 적용됩니다.
Windows Phone 적용: "투명"을 선택하면 시스템 테마 컬러가 사용됩니다. |
"#" 앞에 오는 3바이트 16진수 또는 명명된 색입니다. | 예 | |
| 설명 | 앱에 대한 설명입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 비고 섹션을 참조하세요. |
탭, 캐리지 리턴 및 줄 바꿈과 같은 문자를 포함할 수 없는 1자에서 2048자 사이의 문자열입니다. | 예 | |
| 표시 이름 | 사용자에게 표시할 수 있는 앱의 이름입니다. 이 문자열은 지역화할 수 있습니다. 자세한 내용은 비고 섹션을 참조하세요. Microsoft Store 업로드된 앱의 DisplayName으로 사용할 수 없는 명시적으로 예약된 단어는 "NoUIEntryPoints" 및 "NoUIEntryPoints-DesignMode"입니다. 이러한 식별자는 개발 도구와 테스트 도구 모음에서 사용하도록 예약되어 있습니다. |
길이가 1~256자인 문자열입니다. 이 문자열은 지역화할 수 있습니다. | 예 | |
| ForegroundText | 앱 타일의 전경색을 지정합니다. Windows Phone 적용: "투명"을 선택하면 시스템 테마 컬러가 사용됩니다. |
이 특성 값은 다음 중 하나일 수 있습니다.
|
예 | |
| 로고 | 앱의 사각형 타일로 사용되는 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요. |
".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1~256자인 문자열로, | 다음 >문자를 <포함할 수 없습니다. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다. | 예 | |
| SmallLogo | 앱을 식별하기 위해 타일의 모서리에 표시되는 작은 이미지입니다. 이 특성에서 이미지를 지정하는 방법에 대한 자세한 내용은 비고를 참조하세요. Windows Phone 적용: Windows Phone 타일의 작은 로고를 지원하지 않습니다. 앱 목록에서만 사용됩니다. |
".jpg", ".png" 또는 ".jpeg"로 끝나는 길이가 1~256자인 문자열로, | 다음 >문자를 <포함할 수 없습니다. 이 문자열에서 / 및 \ 문자는 첫 번째 또는 마지막 문자가 될 수 없습니다. 또한 문자열은 /또는 \를 포함할 수 있지만 둘 다 포함할 수는 없습니다. | 예 | |
| ToastCapable | true 값은 앱이 알림 메시지를 제공할 수 있음을 나타냅니다. 기본 값은 false입니다. 알림 메시지를 표시하지 않으려면 이 특성의 값을 지정하지 마세요. 앱은 이 값을 기반으로 알림 메시지를 보낼지 여부를 결정해서는 안 됩니다. |
boolean | 예 |
자식 요소
| 자식 요소 | Description |
|---|---|
| DefaultTile | 시작 화면의 앱을 나타내는 기본 타일입니다. 이 타일은 앱이 처음 설치될 때 업데이트 알림을 받기 전에 표시됩니다. 타일에 표시할 알림이 없으면 타일이 이 기본값으로 되돌아갑니다. |
| InitialRotationPreference | 최상의 사용자 환경을 위해 앱이 표시되는 방향을 설명합니다. 태블릿과 같이 회전할 수 있는 디바이스에서는 여기에 지정되지 않은 방향에 대해 앱이 다시 그려지지 않습니다. 예를 들어 앱이 가로 및 LandscapeFlipped 방향만 지정하고 디바이스가 세로 방향으로 회전하는 경우 앱은 회전하지 않습니다. 회전할 수 없는 디바이스에서는 해당 디바이스의 기본 방향에 앱이 표시될 수 있으며 앱의 기본 방향은 무시됩니다. 그러나 회전 잠금이 활성화된 디바이스에서는 앱의 기본 설정 회전이 계속 적용됩니다. 이러한 방향 기본 설정 선택은 앱에 대한 새 세션이 시작될 때 [시작 화면](element-splashscreen.md) 및 앱 UI 모두에 적용됩니다. [AutoRotationPreferences](/uwp/api/Windows 통해 런타임 중에 기본 설정을 변경할 수 있습니다. Graphics.Display.DisplayInformation) 속성입니다. |
| LockScreen | 시스템이 잠겨 있을 때 표시되는 잠금 화면의 앱을 나타내는 배지 및 알림을 정의합니다. |
| SplashScreen | 시작 화면의 모양을 정의합니다. 시작 화면은 앱이 시작하는 동안 표시됩니다. |
부모 요소
이 가장 바깥쪽(문서) 요소는 다른 요소에 포함되지 않을 수 있습니다.
설명
타일 차원 요구 사항에 대한 자세한 내용은 타일 크기를 참조하세요.
로고 및 SmallLogo 이미지는 이미지 파일의 직접 경로 또는 리소스로 제공될 수 있습니다. 리소스 참조를 사용하여 Windows 디바이스 및 화면 해상도에 가장 적합한 크기를 선택할 수 있도록 다양한 규모의 이미지를 제공할 수 있습니다. 또한 접근성 및 지역화된 이미지를 위해 고대비 이미지를 제공하여 다른 UI 언어와 일치시킬 수 있습니다. 이 기능을 사용하면 DisplayName 및 설명 특성을 지역화할 수도 있습니다 . 자세한 내용은 세계화 항목을 참조하세요.
Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo
두 가지 유형의 로고 이미지에 대한 크기 요구 사항은 다음과 같습니다.
이미지 특성 크기 조정 이미지 크기(픽셀 Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x544
지원되는 배경색 이름은 다음과 같습니다.
| 속성 | 속성 | 속성 | 속성 | 속성 | 속성 |
|---|---|---|---|---|---|
| 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 |
| 핫핑크 | indianRed | indigo | ivory | khaki | lavender |
| lavenderBlush | lawnGreen | lemonChiffon | lightBlue | lightCoral | lightCyan |
| lightGoldenrodYellow | lightGreen | lightGray | 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">
<VisualElements
DisplayName="ApplicationDataSample"
Logo="images\squareTile-sdk.png"
SmallLogo="images\smallTile-sdk.png"
Description="Application data sample"
ForegroundText="dark"
BackgroundColor="#FFFFFF"
ToastCapable="false">
<DefaultTile ShowName="allLogos"/>
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>
</Application>
</Applications>
참고 항목
빠른 시작: Visual Studio 매니페스트 편집기를 사용하여 기본 타일 만들기
요구 사항
| 값 | |
|---|---|
| Namespace | http://schemas.microsoft.com/appx/2010/manifest |