VisualElements (skema ekstensi fitur untuk Windows 8.1)

Artikel
07/20/2023

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

<VisualElements>

Sintaks

<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>

Kunci

? opsional (nol atau satu)

& konektor interleave (dapat terjadi dalam urutan apa pun)

Atribut dan Elemen

Atribut

Atribut	Deskripsi	Jenis Data	Diperlukan	Nilai default
Square150x150Logo	Gambar 150x150 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 dapat 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
Square30x30Logo	Gambar 30x30 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 dapat 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

Elemen Anak

Elemen Anak	Deskripsi
ApplicationView	Menjelaskan bagaimana aplikasi ditampilkan di layar.
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 LanskapFlip, 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.DisplayInformation).
LayarKunci	Menentukan lencana dan pemberitahuan yang mewakili aplikasi pada layar kunci, yang ditampilkan saat sistem dikunci.
SplashScreen	Menentukan tampilan layar splash, yang ditampilkan oleh aplikasi selama peluncuran.

Elemen Induk

Elemen terluar (dokumen) ini mungkin tidak dimuat oleh elemen lain.

Keterangan

Untuk informasi selengkapnya tentang aspek visual untuk aplikasi, lihat VisualElements.

Manifes melakukan pemeriksaan semantik ini untuk VisualElements, yang tidak diberlakukan dalam skema.

Jika DefaultTile\Square310x310Logo ditentukan, DefaultTile\Wide310x150Logo juga harus ditentukan.
Jika DefaultTile\DefaultSize atau ShowNameOnTiles menentukan nilai ukuran gambar tertentu, ukuran gambar tersebut harus dinyatakan dalam manifes.
Jika LockScreen\Notification diatur ke badgeAndTileText, DefaultTile\Wide310x150Logo harus ditentukan.

Gambar Square150x150Logo dan Square30x30Logo dapat diberikan sebagai jalur langsung ke file gambar atau sebagai sumber daya. Dengan menggunakan referensi sumber daya, Anda dapat menyediakan gambar yang dilokalkan agar sesuai dengan bahasa UI yang berbeda. Untuk informasi selengkapnya, lihat topik Globalisasi .

Persyaratan

	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/2013/manifest`

Bagikan melalui