uap:LockScreen (Windows 10)

[アーティクル]
10/30/2023

システムがロックされたときに表示される、ロック画面でアプリを表すバッジと通知を定義します。

要素の階層

<パッケージ>

<アプリケーション>

<uap:VisualElements>

<uap:LockScreen>

構文

<uap:LockScreen
  Notification = 'A string that can have one of the following values: "badge" or "badgeAndTileText".'
  BadgeLogo = 'A string with a value 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.' />

属性と要素

属性

属性	説明	データ型	必須	既定値
通知	ロック画面にアプリに表示できるタイルの種類。これは、状態を伝える数値またはグリフを表示するバッジ、または詳細な状態を表示できるバッジとテキストの両方のいずれかになります。 LockScreen Notification の種類 'badgeAndTileText' が選択されている場合は、WideLogo テンプレートのみがタイルテキストで表示するための適切な情報を提供するため、オプションの WideLogo を指定する必要があります。このイメージが指定されていない場合、タイルは正方形の形式でのみ表示でき、ワイドテンプレートの種類に基づく通知を受け入れることはできません。このルールは、マニフェスト API を通じて意味的に適用されます。	badge または badgeAndTileText のいずれかの値を持つ文字列。	Yes
BadgeLogo	アプリを識別するためのバッジの横に表示されるロゴイメージ。この画像は、.png 型の単色で、24 x 24 ピクセルを測定する必要があります。この属性でイメージを指定する方法の詳細については、「解説」を参照してください。	長さが 1 ~ 256 文字の文字列。末尾が、、またはの文字`>\|?":<`を含めることはできません。`*.jpeg.png.jpg` この文字列では、 `/` 文字と `\` 文字を先頭または最後の文字にすることはできません。また、文字列にはまたはを含めることができますが、両方は含`/\`められません。	Yes

子要素

なし。

親要素

親要素	説明
uap:VisualElements	アプリの視覚的側面 (既定のタイル、ロゴ画像、テキストと背景色、初期画面の向き、スプラッシュスクリーン、ロック画面タイルの外観) について説明します。

注釈

アプリがロック画面に存在するためには、バックグラウンドタスクを処理するために登録する必要もあります。詳細については、ロック画面の概要と uap:BackgroundTasks 要素に関するページを参照してください。

BadgeLogo イメージは、イメージファイルへの直接パスまたはリソースとして指定できます。リソース参照を使用すると、Windows がデバイスと画面の解像度に最適なサイズを選択できるように、さまざまなスケールの画像を提供できます。アクセシビリティのためのハイコントラスト画像や、さまざまな UI 言語に対応するローカライズされた画像を提供することもできます。詳細については、「グローバリゼーション」トピックを参照してください。

バッジロゴイメージのサイズ要件を次に示します。

Image 属性
スケール
画像サイズ (ピクセル単位)
Applications\Application\VisualElements\LockScreen\@BadgeLogo
100
24 x 24
140
33 x 33
180
43 x 43

こちらもご覧ください

必要条件

Item	値
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 バージョン 1511 (ビルド 10586)