VisualElements (skema paket untuk Windows 8)
Menjelaskan aspek visual aplikasi UWP: petak peta default, gambar logo, warna teks dan latar belakang, orientasi layar awal, layar percikan, dan tampilan petak peta layar kunci.
Hierarki elemen
- <Paket>
-
- <Aplikasi>
-
- <Aplikasi>
- <VisualElements>
Sintaks
<VisualElements DisplayName = A string between 1 and 256 characters in length.
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.
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 >
<!-- Child elements -->
( DefaultTile?
& LockScreen?
& SplashScreen
& InitialRotationPreference?
)
</VisualElements>
Kunci
? opsional (nol atau satu)
& konektor interleave (dapat terjadi dalam urutan apa pun)
Atribut dan Elemen
Atribut
| Atribut | Deskripsi | Jenis Data | Diperlukan | Nilai default |
|---|---|---|---|---|
| Warna Latar Belakang | Menentukan warna latar belakang petak peta aplikasi. Lihat bagian Keterangan untuk nama warna. Perhatikan bahwa warna latar belakang yang ditentukan di sini juga berlaku untuk item ini:
|
Angka heksadesimal tiga byte yang didahului oleh "#" atau warna bernama. | Ya | |
| Deskripsi | Deskripsi aplikasi. String ini dapat dilokalkan; lihat Keterangan untuk detailnya. |
Panjang string antara 1 dan 2048 karakter yang tidak dapat menyertakan karakter seperti tab, pengembalian pengangkutan, dan umpan baris. | Ya | |
| DisplayName | Nama yang mudah diingat untuk aplikasi yang dapat ditampilkan kepada pengguna. String ini dapat dilokalkan; lihat Keterangan untuk detailnya. Ada dua kata yang dicadangkan secara eksplisit yang mungkin tidak digunakan sebagai DisplayName untuk aplikasi yang diunggah ke Microsoft Store: "NoUIEntryPoints" dan "NoUIEntryPoints-DesignMode". Pengidentifikasi ini disediakan untuk digunakan oleh alat pengembangan dan rangkaian pengujian. |
Panjang string antara 1 dan 256 karakter. | Ya | |
| ForegroundText | Menentukan warna latar depan petak peta aplikasi.
|
Atribut ini dapat memiliki salah satu nilai berikut:
|
Ya | |
| Logo | Gambar yang digunakan sebagai petak peta persegi aplikasi. Untuk informasi selengkapnya tentang cara menentukan gambar dalam atribut ini, lihat Keterangan. |
Panjang string antara 1 dan 256 karakter yang diakhir dengan ".jpg", ".png", atau ".jpeg" yang tidak boleh berisi karakter ini: <, , : >, %, ", |, ?, atau *. Dalam string ini, karakter / dan \ tidak boleh menjadi karakter pertama atau terakhir. Selain itu, string dapat berisi / atau \ tetapi tidak keduanya. | Ya | |
| SmallLogo | Gambar kecil yang ditampilkan di sudut petak peta untuk mengidentifikasi aplikasi. Untuk informasi selengkapnya tentang cara menentukan gambar dalam atribut ini, lihat Keterangan.
|
Panjang string antara 1 dan 256 karakter yang diakhir dengan ".jpg", ".png", atau ".jpeg" yang tidak boleh berisi karakter ini: <, , : >, %, ", |, ?, atau *. Dalam string ini, karakter / dan \ tidak boleh menjadi karakter pertama atau terakhir. Selain itu, string dapat berisi / atau \ tetapi tidak keduanya. | Ya | |
| ToastCapable | Nilai true menunjukkan bahwa aplikasi diizinkan untuk memberikan pemberitahuan toast. Nilai defaultnya adalah salah. Jika Anda tidak ingin pemberitahuan toast muncul, jangan tentukan nilai untuk atribut ini. Perhatikan bahwa aplikasi tidak boleh membuat keputusan tentang apakah akan mengirim pemberitahuan toast berdasarkan nilai ini. |
boolean | Tidak |
Elemen Anak
| Elemen Anak | Deskripsi |
|---|---|
| DefaultTile | Petak peta default yang mewakili aplikasi di layar Mulai. Petak peta ini ditampilkan saat aplikasi pertama kali diinstal, sebelum menerima pemberitahuan pembaruan apa pun. Saat petak peta tidak memiliki pemberitahuan untuk ditampilkan, petak peta kembali ke default ini. |
| InitialRotationPreference | Menjelaskan orientasi di mana aplikasi lebih suka ditampilkan untuk pengalaman pengguna terbaik. Pada perangkat yang dapat diputar, seperti tablet, aplikasi tidak akan digambar ulang untuk orientasi yang tidak ditentukan di sini. Misalnya, jika aplikasi hanya menentukan orientasi Lanskap dan LandscapeFlipped, dan perangkat diputar ke orientasi Potret, aplikasi tidak akan berputar. Perhatikan bahwa pada perangkat yang tidak dapat diputar, aplikasi mungkin ditampilkan dalam orientasi default perangkat tersebut dan orientasi pilihan aplikasi akan diabaikan. Namun, pada perangkat dengan kunci rotasi diaktifkan, rotasi pilihan aplikasi Anda akan tetap dihormati. Pilihan preferensi orientasi ini berlaku untuk [layar percikan](element-splashscreen.md) dan UI aplikasi saat sesi baru diluncurkan untuk aplikasi Anda. Preferensi dapat diubah selama durasi melalui properti [AutoRotationPreferences](/uwp/api/Windows.Graphics.Display.DisplayProperties). |
| LayarKunci | Menentukan lencana dan pemberitahuan yang mewakili aplikasi di layar kunci, yang ditampilkan saat sistem dikunci. |
| Layar Splash | Menentukan tampilan layar percikan, yang ditampilkan oleh aplikasi selama peluncuran. |
Elemen Induk
| Elemen Induk | Deskripsi |
|---|---|
| Aplikasi | Mewakili aplikasi yang terdiri dari atau semua fungsionalitas yang dikirimkan dalam paket. |
Keterangan
Untuk informasi selengkapnya tentang persyaratan dimensi petak peta, lihat Ukuran petak peta.
Gambar Logo dan SmallLogo dapat diberikan sebagai jalur langsung ke file gambar atau sebagai sumber daya. Dengan menggunakan referensi sumber daya, Anda dapat menyediakan gambar dengan skala yang berbeda sehingga Windows dapat memilih ukuran terbaik untuk resolusi perangkat dan layar. Anda juga dapat menyediakan gambar kontras tinggi untuk aksesibilitas dan gambar yang dilokalkan agar sesuai dengan bahasa UI yang berbeda. Fitur ini juga memungkinkan Anda untuk melokalisasi atribut DisplayName dan Description . Untuk informasi selengkapnya, lihat topik Globalisasi .
Aplikasi/Aplikasi/Ekstensi/Ekstensi/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo
Persyaratan ukuran dua jenis gambar logo ditampilkan di sini:
Ukuran Gambar Skala atribut gambar dalam piksel Applications\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54
Ini adalah nama warna latar belakang yang didukung:
| Nama | Nama | Nama | Nama | Nama | Nama |
|---|---|---|---|---|---|
| aliceBlue | antikWhite | Aqua | Aquamarine | Azure | beige |
| Bisque | Hitam | blanchedAlmond | Biru | blueViolet | Brown |
| burlyWood | cadetBlue | Chartreuse | Cokelat | Coral | cornflowerBlue |
| cornsilk | Crimson | sian | darkBlue | darkCyan | darkGoldenrod |
| darkGray | darkGreen | darkKhaki | darkMagenta | darkOliveGreen | darkOrange |
| darkOrchid | berwarna gelap | darkSalmon | darkSeaGreen | darkSlateBlue | darkSlateGray |
| darkTurquoise | darkViolet | deepPink | deepSkyBlue | dimGray | dodgerBlue |
| firebrick | floralWhite | forestGreen | Fuchsia | gainsboro | ghostWhite |
| Emas | Goldenrod | Abu | green | greenYellow | Honeydew |
| hotPink | indianRed | Indigo | Gading | Khaki | Lavender |
| lavenderBlush | rumputGreen | lemonChiffon | lightBlue | lightCoral | Bahasa LightCyan |
| lightGoldenrodYellow | lightGreen | lightGray | lightPink | lightSalmon | lightSeaGreen |
| lightSkyBlue | lightSlateGray | lightSteelBlue | lightYellow | Kapur | limeGreen |
| Linen | magenta | Maroon | mediumAquamarine | mediumBlue | mediumOrchid |
| mediumPurple | mediumSeaGreen | mediumSlateBlue | mediumSpringGreen | mediumTurquoise | mediumVioletRed |
| midnightBlue | mintCream | mistyRose | Moccasin | navajoWhite | Angkatan laut |
| oldLace | Zaitun | oliveDrab | Orange | berwarna oranye | Orchid |
| paleGoldenrod | paleGreen | paleTurquoise | paleVioletRed | pepayaHip | peachPuff |
| Peru | Pink | Prem | powderBlue | Ungu | red |
| rosyBrown | royalBlue | saddleBrown | Salmon | sandyBrown | seaGreen |
| Seashell | Sienna | Perak | Skyblue | slateBlue | slateGray |
| snow | springGreen | steelBlue | tan | Teal | Thistle |
| Tomat | Transparan | Pirus | Violet | Gandum | Putih |
| Whitesmoke | Kuning | yellowGreen |
Contoh
Contoh berikut diambil dari manifes paket sampel 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>
Lihat juga
Cuplikan layar dan gambar aplikasi
Mulai cepat: Membuat petak peta default menggunakan editor manifes Visual Studio
Persyaratan
| Nilai | |
|---|---|
| Ruang nama | http://schemas.microsoft.com/appx/2010/manifest |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk