Anheften sekundärer Kacheln aus Desktop-Apps

Legen Sie in der Projektdatei die TargetFramework-Eigenschaft auf einen Wert fest, der Ihnen Zugriff auf die Windows-Runtime-APIs ermöglicht (siehe .NET 6 und höher: Verwenden Der Zielframework-Moniker-Option). Dies umfasst den Zugriff auf den WinRT.Interop-Namespace (siehe Aufrufen von Interop-APIs aus einer .NET-App). Zum Beispiel:

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

Initialisieren Sie ein neues sekundäres Kachelobjekt genau wie bei einer normalen UWP-App. Weitere Informationen zum Erstellen und Anheften von sekundären Kacheln finden Sie unter "Sekundäre Kacheln anheften".

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

Rufen Sie ein Fensterhandle ab, und initialisieren Sie das sekundäre Kachelobjekt mit diesem Handle. Im folgenden this Code ist ein Verweis auf das Window-Objekt (ob WinUI 3-Fenster, WPF-Fenster oder WinForms-Fenster). Weitere Informationen finden Sie unter Abrufen eines Fensterhandles (HWND) und Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

Fordern Sie schließlich an, die Kachel wie in einer normalen UWP-App anzuheften.

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

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

Verwenden Sie die Attribute "ComImport " und "Guid ", um die IInitializeWithWindow-Schnittstelle zu deklarieren.

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

Initialisieren Sie ein neues sekundäres Kachelobjekt genau wie bei einer normalen UWP-App. Weitere Informationen zum Erstellen und Anheften von sekundären Kacheln finden Sie unter "Sekundäre Kacheln anheften".

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

Rufen Sie ein Fensterhandle ab, und initialisieren Sie das sekundäre Kachelobjekt mit diesem Handle. Weitere Informationen finden Sie unter Abrufen eines Fensterhandles (HWND) und Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

Fordern Sie schließlich an, die Kachel wie in einer normalen UWP-App anzuheften.

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

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

Fügen Sie Ihrer Datei Folgendes hinzu pch.h . shobjidl.h bietet Zugriff auf die IInitializeWithWindow-Schnittstelle ; Microsoft.UI.Xaml.Window.h bietet Zugriff auf die WinUI 3 Window-Klasse .

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

Initialisieren Sie ein neues sekundäres Kachelobjekt genau wie bei einer normalen UWP-App. Weitere Informationen zum Erstellen und Anheften von sekundären Kacheln finden Sie unter "Sekundäre Kacheln anheften".

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

Rufen Sie ein Fensterhandle ab, und initialisieren Sie das sekundäre Kachelobjekt mit diesem Handle. Im folgenden this Code befindet sich ein Zeiger auf ein WinUI 3 Window-Objekt . Weitere Informationen finden Sie unter Abrufen eines Fensterhandles (HWND) und Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

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

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

Fordern Sie schließlich an, die Kachel wie in einer normalen UWP-App anzuheften.

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

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