ウィジェット ピッカーと統合する

現在のリリースでは、ウィジェット ホストは、Windows 11に組み込まれているウィジェット ボードのみです。 ウィジェットボードはウィジェットを表示し、ボード上のレイアウトを管理します。 また、ユーザーがボード上に表示される使用可能なウィジェットを選択できるウィジェット ピッカーも提供されます。 この記事では、ウィジェットがウィジェット ピッカーに正常に統合するために必要な資産について説明します。

ウィジェットのスクリーンショット画像

各ウィジェットには、ウィジェットにフォーカスがあるときに、ウィジェット ピッカーにプレビューとして表示されるスクリーンショット イメージが用意されている必要があります。 スクリーンショットは、アプリのパッケージ マニフェストでウィジェット プロバイダーによって指定されています。 ウィジェットのスクリーンショットに使用するイメージ ファイルを指定する方法の技術情報については、「 Win32 アプリでウィジェット プロバイダーを実装 する」および「 ウィジェット プロバイダー パッケージ マニフェスト XML 形式」を参照してください。

次のスクリーンショットは、ウィジェット ピッカー内でのスクリーンショット イメージの配置を示しています。

スクリーンショットの画像の要件

一貫性のあるユーザー エクスペリエンスを提供するには、ウィジェット ピッカーのウィジェット のスクリーンショットが次のガイドラインに従っている必要があります。

• スクリーンショットには、ウィジェットの中サイズバージョンが表示されます。
• 画像は幅 300 ピクセル、高さ 304 ピクセルにする必要があります。
• イメージには、透明で丸みを帯びた角が必要です。

ウィジェット プロバイダー マニフェストには、設定できる 3 つの異なる スクリーンショット 要素が含まれています。 最上位のスクリーンショットは必須であり、ウィジェット ピッカーによって既定として使用されます。 マニフェストの LightMode セクションと DarkMode セクションは省略可能であり、ライト モードとダーク モードでウィジェットの個別のスクリーンショットを指定できます。 これらのオプションのスクリーンショットの一方または両方を指定した場合、ウィジェット ピッカーでは、デバイスの現在のテーマに一致するものが使用されます。 現在のテーマ専用のイメージを指定しない場合、ウィジェット ピッカーでは、代わりに既定の最上位のスクリーンショットが使用されます。

複数のロケールにウィジェットのスクリーンショットを提供できます。 各スクリーンショットのロケールは、アプリ パッケージに対する相対的な資産へのパスで指定されます。

• イメージアセットのパッケージ化プロジェクトにディレクトリを作成します。 たとえば、"Assets" です。
• 言語に依存しないアセットまたはフォールバック アセットは、このフォルダーに直接配置できます。 例: "Assets/Screenshot.png"
• 言語固有のアセットは、適用先のロケールにちなんだという名前のサブディレクトリに配置できます。 次に例を示します。
  • "英語 (米国)" アセットは、"en-us": "Assets/en-us/Screenshot.png" という名前のサブディレクトリに配置する必要があります
  • "フランス語 (フランス)" アセットは、"fr-fr": "Assets/fr-fr/Screenshot.png" という名前のサブディレクトリに配置する必要があります
• ms-appx: URI スキームを使用して、appxmanifest でこれらのイメージを参照します。 例: Screenshot="ms-appx:Assets\Screenshot.png"
• 特定のロケールのイメージを含めない場合は、ルート ディレクトリ内のフォールバック イメージが使用されます。

リソース ローダーは、表示する言語に適した資産を自動的に選択します。 詳細については、「 スケール、テーマ、ハイ コントラストなどに合わせて調整されたイメージとアセットを読み込む」を参照してください。

ウィジェットのスクリーンショット画像の例を次に示します。