uap:VisualElements (Windows 10)

  • Artikel

Menjelaskan aspek visual aplikasi: 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>

              <uap:VisualElements>

Sintaks

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

Kunci

? konektor interleave opsional (nol atau satu) & (dapat terjadi dalam urutan apa pun)

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
DisplayName Nama yang mudah diingat untuk aplikasi yang dapat ditampilkan kepada pengguna. String ini dapat dilokalkan; lihat Keterangan untuk detailnya. String dengan nilai antara 1 dan 256 karakter. String ini dapat dilokalkan. Ya
Deskripsi Deskripsi aplikasi. String ini dapat dilokalkan; lihat Keterangan untuk detailnya. String antara 1 dan 2048 karakter. Ya
Warna Latar Belakang Menentukan warna latar belakang petak peta aplikasi. Lihat bagian Keterangan untuk nama warna. Ya
Square150x150Logo Gambar yang digunakan sebagai petak peta sedang Layar Mulai aplikasi, dan pada Pengalih Tugas. Untuk informasi selengkapnya tentang cara menentukan gambar dalam atribut ini, lihat Keterangan. String dengan panjang antara 1 dan 256 karakter yang berakhiran dengan , , atau .jpeg yang tidak boleh berisi karakter ini: <, , >, ":, |, ?, atau *. .png.jpg Dalam string ini, / karakter dan \ tidak boleh menjadi karakter pertama atau terakhir. Selain itu, string dapat berisi / atau \ tetapi tidak keduanya. Ya
Square44x44Logo Gambar yang digunakan sebagai petak peta kecil Layar Mulai aplikasi, dan di Daftar Semua Aplikasi. Untuk informasi selengkapnya tentang cara menentukan gambar dalam atribut ini, lihat Keterangan. String dengan panjang antara 1 dan 256 karakter yang berakhiran dengan , , atau .jpeg yang tidak boleh berisi karakter ini: <, , >, ":, |, ?, atau *. .png.jpg Dalam string ini, / karakter dan \ tidak boleh menjadi karakter pertama atau terakhir. Selain itu, string dapat berisi / atau \ tetapi tidak keduanya. Ya
AppListEntry Entri di Daftar Semua Aplikasi. Pilih tidak ada untuk titik masuk yang tidak memerlukan petak peta menu mulai. String opsional yang dapat memiliki salah satu nilai berikut: "default" atau "none". Tidak default

Catatan

Warna latar belakang yang ditentukan di sini juga berlaku untuk item ini:

  • Warna tombol dalam kotak dialog milik aplikasi apa pun
  • Halaman Deskripsi Aplikasi di Bursa

Elemen anak

elemen anak Deskripsi
uap: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.
uap: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 Landscape menentukan dan LandscapeFlipped orientasi, dan perangkat diputar ke Portrait orientasi, aplikasi tidak akan berputar.
uap:LockScreen Menentukan lencana dan pemberitahuan yang mewakili aplikasi pada layar kunci, yang ditampilkan saat sistem dikunci.
uap:SplashScreen Menentukan tampilan layar splash, yang ditampilkan oleh aplikasi selama peluncuran.

Catatan

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 splash dan UI aplikasi saat sesi baru diluncurkan untuk aplikasi Anda. Preferensi dapat diubah selama durasi melalui properti AutoRotationPreferences .

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.

Untuk gambar Square150x150Logo dan Square44x44Logo , Anda dapat menyediakan gambar dengan skala yang berbeda sehingga Windows dapat memilih ukuran terbaik untuk perangkat dan resolusi 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:

Atribut gambar Skala (Ukuran gambar dalam piksel)
Applications/Application/VisualElements/@Square150x150Logo 100 (150x150)
250 (375x375)
Applications/Application/VisualElements/@Square44x44Logo 100 (44x44)
250 (110x110)
Applications/Application/VisualElements/@Tall150x310Logo 100 (150x310)
250 (375x775)

Ini adalah nama warna latar belakang yang didukung:

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
lightGray
lightGreen
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
pepayaWhip
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">
        <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>

Lihat juga

Persyaratan

Item Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/uap/windows10
Versi OS Minimum Windows 10 versi 1511 (Build 10586)