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

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

Von Bedeutung

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

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

アプリをパッケージ化する

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

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

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

C# (.NET 6 以降)

注

このセクションは 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, "net8.0-windows10.0.19041.0" -->
     <TargetFramework>net8.0-windows10.0.19041.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
   

タイル通知を送信する

Von Bedeutung

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

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

リソース

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