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

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

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

Инициализация нового вторичного объекта плитки точно так же, как и обычное приложение 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 3, окно 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 3 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 3. Дополнительные сведения см. в разделе "Получение дескриптора окна" (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