将次要磁贴从桌面应用中固定

在项目文件中，将 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>

像使用普通 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) 和 显示依赖于 CoreWindow 的 WinRT UI 对象。

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) 和 显示依赖于 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);

最后，请求像在普通 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);

检索窗口句柄，并使用该句柄初始化辅助磁贴对象。 在下面的代码中， 是一个指向 WinUI 3 窗口 对象的 指针。 有关详细信息，请参阅 检索窗口句柄 (HWND) 和 显示依赖于 CoreWindow 的 WinRT UI 对象。

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