デスクトップ アプリからセカンダリ タイルをピン留めする

WinUI 3 アプリ (Windows アプリ SDKを使用)、Windows Presentation Foundation (WPF) またはWindows フォーム (WinForms) アプリなどのデスクトップ アプリは、パッケージ 化されたアプリを使用してセカンダリ タイルをピン留めできます (「コードから MSIX パッケージをビルドする」を参照)。 これは、以前は デスクトップ ブリッジ と呼れていました。

重要

Fall Creators Update が必要: デスクトップ ブリッジ アプリからセカンダリ タイルをピン留めするには、SDK 16299 をターゲットとし、ビルド 16299 以降を実行している必要があります。

Windows アプリ SDK、WPF、または WinForms アプリケーションからセカンダリ タイルを追加することは、純粋な UWP アプリとよく似ています。 唯一の違いは、メイン ウィンドウのハンドル (HWND) を指定する必要があることです。 これは、タイルをピン留めするときに、モーダル ダイアログが表示され、タイルをピン留めするかどうかをユーザーに確認するためです。 デスクトップ アプリケーションで SecondaryTile オブジェクトが所有者ウィンドウで構成されていない場合、Windows はダイアログを描画する場所を知らないので、操作は失敗します。

アプリのパッケージ化

WinUI 3 でWindows アプリ SDK アプリケーションを作成する場合は、パッケージ化されたアプリケーションを使用してセカンダリ タイルをピン留めする必要があります。 パッケージ化されたアプリ テンプレートから開始する場合、アプリのパッケージ化に必要な追加の手順はありません。

WPF または WinForms を使用していて、アプリをデスクトップ ブリッジでパッケージ化していない場合は、Windows ランタイム API を使用する前にこれを行う必要があります (「コードから MSIX パッケージをビルドする」を参照してください)。

IInitializeWithWindow インターフェイスを使用してセカンダリ タイルを初期化してピン留めする

C# (.NET 6 以降)

Note

このセクションは WinUI 3 用です。および .NET 6 以降を使用する WPF/WinForms の場合は 。

1. プロジェクト ファイルで、TargetFramework プロパティを、Windows ランタイム API へのアクセスを許可する値に設定します (「.NET 6 以降: ターゲット フレームワーク モニカー オプションを使用する」を参照)。 これには 、WinRT.Interop 名前空間へのアクセスが含まれます ( 「.NET アプリから相互運用 API を呼び出す」を参照してください)。 次に例を示します。

   <PropertyGroup>
     <!-- You can also target other versions of the Windows SDK and .NET; for example, "net6.0-windows10.0.19041.0" -->
     <TargetFramework>net6.0-windows10.0.22000.0</TargetFramework>
   </PropertyGroup>
   

2. 通常の UWP アプリの場合とまったく同じように、新しいセカンダリ タイル オブジェクトを初期化します。 セカンダリ タイルの作成とピン留めについて詳しくは、「セカンダリ タイルをピン留めする」をご覧ください。

   // Initialize the tile with required arguments
   var tile = new Windows.UI.StartScreen.SecondaryTile(
       "myTileId5391",
       "Display name",
       "myActivationArgs",
       new Uri("ms-appx:///Assets/Square150x150Logo.png"),
       TileSize.Default);
   

3. ウィンドウ ハンドルを取得し、そのハンドルを使用してセカンダリ タイル オブジェクトを初期化します。 次のコードでは、 this は Window オブジェクトへの参照です (WinUI 3 ウィンドウ、WPF ウィンドウ、WinForms ウィンドウのいずれであっても)。 詳細については、「 ウィンドウ ハンドルの取得 (HWND)」 および 「CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。

   var hWnd = WinRT.Interop.WindowNative.GetWindowHandle(this);
   WinRT.Interop.InitializeWithWindow.Initialize(tile, hWnd);
   

4. 最後に、通常の UWP アプリと同様にタイルをピン留めするように要求します。

   // Pin the tile
   bool isPinned = await tile.RequestCreateAsync();
   
   // Here, update UI to reflect whether user can now either unpin or pin
   

C# (以前のバージョンの .NET)

注意

このセクションは、.NET のバージョンが 5 より前の WPF/WinForms 用です。

1. ComImport 属性と Guid 属性を使用して、IInitializeWithWindow インターフェイスを宣言します。

   [System.Runtime.InteropServices.ComImport]
   [System.Runtime.InteropServices.Guid("3E68D4BD-7135-4D10-8018-9FB6D9F33FA1")]
   [System.Runtime.InteropServices.InterfaceType(
       System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown
   )]
   public interface IInitializeWithWindow
   {
       void Initialize(IntPtr hWnd);
   }
   

2. 通常の UWP アプリの場合とまったく同じように、新しいセカンダリ タイル オブジェクトを初期化します。 セカンダリ タイルの作成とピン留めについて詳しくは、「セカンダリ タイルをピン留めする」をご覧ください。

   // Initialize the tile with required arguments
   var tile = new Windows.UI.StartScreen.SecondaryTile(
       "myTileId5391",
       "Display name",
       "myActivationArgs",
       new Uri("ms-appx:///Assets/Square150x150Logo.png"),
       TileSize.Default);
   

3. ウィンドウ ハンドルを取得し、そのハンドルを使用してセカンダリ タイル オブジェクトを初期化します。 詳細については、「 ウィンドウ ハンドルの取得 (HWND)」 および 「CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。

   var wih = new System.Windows.Interop.WindowInteropHelper(this);
   var hWnd = wih.Handle; // For a WinForms window object, access the NativeWindow.Handle property instead.
   IInitializeWithWindow initWindow = (IInitializeWithWindow)(object)tile;
   initWindow.Initialize(hWnd);
   

4. 最後に、通常の UWP アプリと同様にタイルをピン留めするように要求します。

   // Pin the tile
   bool isPinned = await tile.RequestCreateAsync();
   
   // Here, update UI to reflect whether user can now either unpin or pin
   

C++

1. ファイルに次のインクルードを追加します pch.h 。 shobjidl.h は 、IInitializeWithWindow インターフェイスへのアクセスを提供します。 Microsoft.UI.Xaml.Window.h は、WinUI 3 Window クラスへのアクセスを提供します。

   #include <shobjidl.h>
   #include <winrt/Windows.Foundation.h> 
   #include <winrt/Windows.UI.StartScreen.h>
   #include <Microsoft.UI.Xaml.Window.h>
   

2. 通常の UWP アプリの場合とまったく同じように、新しいセカンダリ タイル オブジェクトを初期化します。 セカンダリ タイルの作成とピン留めについて詳しくは、「セカンダリ タイルをピン留めする」をご覧ください。

   auto tile = Windows::UI::StartScreen::SecondaryTile(
           L"myTileId5391",
           L"Display name",
           L"myActivationArgs",
           Windows::Foundation::Uri(L"ms-appx:///Assets/Square150x150Logo.png"),
           Windows::UI::StartScreen::TileSize::Default);
   

3. ウィンドウ ハンドルを取得し、そのハンドルを使用してセカンダリ タイル オブジェクトを初期化します。 次のコードでは、 this は WinUI 3 Window オブジェクトへのポインターです。 詳細については、「 ウィンドウ ハンドルの取得 (HWND)」 および 「CoreWindow に依存する WinRT UI オブジェクトの表示」を参照してください。

   auto windowNative{ this->m_inner.as<::IWindowNative>() };
   HWND hWnd{ 0 };
   windowNative->get_WindowHandle(&hWnd);
   
   tile.as<IInitializeWithWindow>()->Initialize(hWnd);
   

4. 最後に、通常の UWP アプリと同様にタイルをピン留めするように要求します。

   // Pin the tile
   bool isPinned = co_await tile.RequestCreateAsync();
   
   // Here, update UI to reflect whether user can now either unpin or pin
   

タイル通知を送信する

重要

2018 年 4 月のバージョン 17134.81 以降が必要: ビルド 17134.81 以降を実行してデスクトップ ブリッジ アプリからセカンダリ タイルにタイル通知またはバッジ通知を送信する必要があります。 この.81 サービス更新プログラムの前に、デスクトップ ブリッジ アプリからセカンダリ タイルにタイル通知またはバッジ通知を送信するときに a 0x80070490 要素が見つかりませんという例外が発生します。

タイル通知またはバッジ通知の送信は UWP アプリと同じです。 手順については、「ローカル タイル通知の送信」を参照してください。

リソース

• セカンダリ タイル サンプル アプリ
• セカンダリ タイルの概要
• セカンダリ タイルをピン留めする (UWP)
• Desktop Bridge
• デスクトップ ブリッジのコード サンプル