Закрепление вторичных плиток из настольных приложений

В файле проекта задайте для свойства TargetFramework значение, которое обеспечивает доступ к API Windows Runtime (см. .NET 6 и более поздние версии: используйте параметр обозначения целевой платформы). Это включает доступ к пространству имен WinRT.Interop (см. Вызов межоперационных API из приложения .NET). Например:

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

Инициализируйте новый объект вторичной плитки так же, как и в обычном приложении 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);

Получите дескриптор окна и инициализируйте вторичную плитку с помощью этого дескриптора. В приведенном ниже коде this является ссылкой на объект Window (будь то окно WinUI, окно WPF или окно WinForms). Дополнительные сведения см. в статьях Извлечение дескриптора окна (HWND) и Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

Затем создайте запрос на закрепление плитки, как в обычном приложении UWP.

// Pin the tile
bool isPinned = await tile.RequestCreateAsync();

// Here, update UI to reflect whether user can now either unpin or pin

Используйте 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);
}

Инициализируйте новый объект вторичной плитки так же, как и в обычном приложении 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);

Получите дескриптор окна и инициализируйте вторичную плитку с помощью этого дескриптора. Дополнительные сведения см. в статьях Извлечение дескриптора окна (HWND) и Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

Затем создайте запрос на закрепление плитки, как в обычном приложении UWP.

// Pin the tile
bool isPinned = await tile.RequestCreateAsync();

// Here, update UI to reflect whether user can now either unpin or pin

Добавьте следующие элементы в файл pch.h. shobjidl.h предоставляет доступ к интерфейсу IInitializeWithWindow; Microsoft.UI.Xaml.Window.h предоставляет доступ к классу WinUI Window.

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

Инициализируйте новый объект вторичной плитки так же, как и в обычном приложении 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);

Получите дескриптор окна и инициализируйте вторичную плитку с помощью этого дескриптора. В приведенном ниже this коде является указателем на объект Окно WinUI. Дополнительные сведения см. в статьях Извлечение дескриптора окна (HWND) и Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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

tile.as<IInitializeWithWindow>()->Initialize(hWnd);

Затем создайте запрос на закрепление плитки, как в обычном приложении UWP.

// Pin the tile
bool isPinned = co_await tile.RequestCreateAsync();

// Here, update UI to reflect whether user can now either unpin or pin