Freigeben über


SecondaryTile Klasse

Definition

Erstellt, listet und stellt Informationen zu einer sekundären Kachel bereit.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen, und sekundäre Kacheln aus Desktop-Apps anheften.

public ref class SecondaryTile sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SecondaryTile final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SecondaryTile
function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)
Public NotInheritable Class SecondaryTile
Vererbung
Object Platform::Object IInspectable SecondaryTile
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird eine sekundäre Kachel erstellt und an den Startbildschirm angeheftet.

using Windows.UI.StartScreen;

// Prepare package images for all four tile sizes in our tile to be pinned as well as for the square30x30 logo used in the Apps view.  
Uri square150x150Logo = new Uri("ms-appx:///Assets/square150x150Tile-sdk.png");
Uri wide310x150Logo = new Uri("ms-appx:///Assets/wide310x150Tile-sdk.png");
Uri square310x310Logo = new Uri("ms-appx:///Assets/square310x310Tile-sdk.png"); 
Uri square30x30Logo = new Uri("ms-appx:///Assets/square30x30Tile-sdk.png");

// During creation of secondary tile, an application may set additional arguments on the tile that will be passed in during activation.
// These arguments should be meaningful to the application. In this sample, we'll pass in the date and time the secondary tile was pinned.
string tileActivationArguments = MainPage.logoSecondaryTileId + " WasPinnedAt=" + DateTime.Now.ToLocalTime().ToString();

// Create a Secondary tile with all the required arguments.
// Note the last argument specifies what size the Secondary tile should show up as by default in the Pin to start fly out.
// It can be set to TileSize.Square150x150, TileSize.Wide310x150, or TileSize.Default.  
// If set to TileSize.Wide310x150, then the asset for the wide size must be supplied as well.
// TileSize.Default will default to the wide size if a wide size is provided, and to the medium size otherwise. 
SecondaryTile secondaryTile = new SecondaryTile(MainPage.logoSecondaryTileId,
                                                "Title text shown on the tile",
                                                tileActivationArguments,
                                                square150x150Logo,
                                                TileSize.Square150x150);

// Pin the tile
bool isPinned = await tile.RequestCreateAsync();
if (isPinned) {
    // Secondary tile successfully pinned.
} 
else {
    // Secondary tile not pinned.
}

Im folgenden Beispiel wird veranschaulicht, wie sie eine sekundäre Kachel mithilfe der RequestDeleteAsync-Methode löschen (aufheben). Beachten Sie, dass in diesem Beispiel davon ausgegangen wird, dass die Kachel vorhanden ist. Informationen dazu, ob die Kachel angeheftet ist, bevor Sie RequestDeleteAsync aufrufen, finden Sie in der Exists-Methode .

// Check if the secondary tile is pinned
if (SecondaryTile.Exists(tileId)) {
    // Initialize a secondary tile with the same tile ID you want removed
    SecondaryTile toBeDeleted = new SecondaryTile(tileId);

    // And then unpin the tile
    bool isDeleted = await toBeDeleted.RequestDeleteAsync();
    if (isDeleted) {
        // Secondary tile successfully deleted.
    } else {
        // Secondary tile not deleted.
    }
}

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der FindAllForPackageAsync-Methode eine Liste von IDs für alle sekundären Kacheln abrufen, die für die aufrufende App und jede andere App im gleichen Paket erstellt wurden.

// Get all secondary tiles
var tiles = await SecondaryTile.FindAllForPackageAsync();

Im folgenden Beispiel wird veranschaulicht, wie die TileUpdateManager.createTileUpdaterForSecondaryTile-Methode verwendet wird, um eine Benachrichtigung an eine sekundäre Kachel mit der ID "SecondaryTile.Dynamic" zu senden. Beachten Sie, dass das Beispiel sowohl eine breite als auch eine quadratische Version der Benachrichtigung bereitstellt, da der Benutzer die Kontrolle darüber hat, welche Form der Kachel angezeigt wird.

using NotificationsExtensions.TileContent;

// Define the notification context.
// Note: This sample contains an additional reference, NotificationsExtensions, which you can use in your apps
ITileWide310x150Text04 tileContent = TileContentFactory.CreateTileWide310x150Text04();
tileContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationsExtensions!";

// Provide a square version of the notification.
ITileSquare150x150Text04 squareContent = TileContentFactory.CreateTileSquare150x150Text04();
squareContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationExtensions!";
tileContent.Square150x150Content = squareContent;

// Send the notification to the secondary tile by creating a secondary tile updater
TileUpdateManager.CreateTileUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(tileContent.CreateNotification());

Im folgenden Beispiel wird veranschaulicht, wie die BadgeUpdateManager.createBadgeUpdaterForSecondaryTile-Methode verwendet wird, um eine numerische Badgebenachrichtigung an eine sekundäre Kachel mit der ID "SecondaryTile.Dynamic" zu senden.

using NotificationsExtensions.BadgeContent;

// Define the badge content
BadgeNumericNotificationContent badgeContent = new BadgeNumericNotificationContent(6);

// Send the notification to the secondary tile
BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(badgeContent.CreateNotification());

Konstruktoren

SecondaryTile()

Erstellt ein SecondaryTile-Objekt . Der Aufrufer muss dann alle obligatorischen Eigenschaften über das Objekt festlegen, bevor er versucht, die Kachel anzuheften, zu aktualisieren oder zu löschen.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

SecondaryTile(String)

Erstellt ein SecondaryTile-Objekt mit einer bestimmten ID. Diese Form des Konstruktors sollte verwendet werden, um ein sekundäres Kachelobjekt zu erstellen, um eine Kachelaktualisierung oder -löschung durchzuführen.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

SecondaryTile(String, String, String, String, TileOptions, Uri)

Hinweis

Dieser Konstruktor kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Erstellt ein SecondaryTile-Objekt als mittlere Kachel.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

Hinweis

Dieser Konstruktor kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) und geben Sie andere Kachelgrößen und Optionen über die SecondaryTile.VisualElements-Methode an.

Erstellt ein SecondaryTile-Objekt als breite Kachel.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

In Windows Phone 8.1 werden alle Kacheln – einschließlich sekundärer Kacheln – als mittlere Kacheln angeheftet, nach denen sie vom Benutzer geändert werden können. Dieser Konstruktor bietet die Möglichkeit, die Größe auf eine breite Kachel zu ändern.

SecondaryTile(String, String, String, Uri, TileSize)

Erstellt ein SecondaryTile-Objekt , das alle obligatorischen Eigenschaften enthält, die zum Erstellen einer mittleren Kachel erforderlich sind.

In einer Desktop-App müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen, bevor Sie eine instance dieser Klasse auf eine Weise verwenden, die die Benutzeroberfläche anzeigt. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Eigenschaften

Arguments

Ruft einen von der App definierten Satz von Informationen ab, der bei der Aktivierung von der sekundären Kachel an die App übergeben wird, oder legt diesen fest. Diese Eigenschaft ist erforderlich, wenn Sie eine Kachel erstellen.

BackgroundColor

Hinweis

BackgroundColor kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTileVisualElements.BackgroundColor.

Ruft die Hintergrundfarbe der Kachel ab oder legt diese fest.

DisplayName

Ruft einen Namen ab, der der Kachel zugeordnet und angezeigt wird, oder legt diesen fest. Dieser Name wird auf der Kachel in start, in der QuickInfo der Kachel neben der kleinen Kacheldarstellung in der Liste Apps und in einigen Systemsteuerung Anwendungen angezeigt. Diese Eigenschaft ist erforderlich, wenn Sie eine Kachel erstellen. Es entspricht dem Anzeigenamen, der im Manifest für die Standard Kachel der App deklariert wurde.

Auf Windows Phone 8.1 wird der Anzeigename nur auf der breiten sekundären Kachel angezeigt.

ForegroundText

Hinweis

ForegroundText kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTileVisualElements.ForegroundText.

Ruft ab, ob die Kachel dunklen oder hellen Text verwenden soll, oder legt diesen fest.

LockScreenBadgeLogo

Ruft den Speicherort eines Badgelogobilds ab, das die sekundäre Kachel auf dem Sperrbildschirm darstellt, oder legt diesen fest. Durch Die Bereitstellung dieses Bilds erklären Sie, dass die sekundäre Kachel berechtigt ist, ein Signal auf dem Sperrbildschirm anzuzeigen. Wenn die sekundäre Kachel auch für den detaillierten Kachelslot des Sperrbildschirms geeignet sein soll, müssen Sie auch die LockScreenDisplayBadgeAndTileText-Eigenschaft auf True festlegen.

Hinweis

Die Angabe, dass Ihre sekundäre Kachel für eine Sperrbildschirmpräsenz geeignet ist, garantiert nicht, dass sie über einen verfügt. Nur der Benutzer kann eine App zu einem der sieben Sperrbildschirmslots hinzufügen. Weitere Informationen finden Sie in der Übersicht über den Sperrbildschirm.

LockScreenDisplayBadgeAndTileText

Ruft ab oder legt fest, ob die sekundäre Kachel zum Anzeigen eines Badges und einer detaillierten Kachel auf dem Sperrbildschirm berechtigt ist. Wenn Sie diese Eigenschaft auf True festlegen, müssen Sie auch ein Badgebild über die Eigenschaft LockScreenBadgeLogo bereitstellen. Wenn Sie die detaillierte Kachelfunktion nicht verwenden möchten, geben Sie über die LockScreenBadgeLogo-Eigenschaft ein Badgebild an, und legen Sie LockScreenDisplayBadgeAndTileText auf False fest.

Hinweis

Die Angabe, dass Ihre sekundäre Kachel für eine Sperrbildschirmpräsenz geeignet ist, garantiert nicht, dass sie über einen verfügt. Nur der Benutzer kann eine App zu einem der sieben Sperrbildschirmslots hinzufügen und auswählen, welcher von ihnen detaillierte Kachelinformationen anzeigen kann. Weitere Informationen finden Sie in der Übersicht über den Sperrbildschirm.

Logo

Hinweis

Das Logo kann nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTileVisualElements.Square150x150Logo.

Ruft das Logobild ab, das in einer mittleren Kachel verwendet wird, oder legt es fest. Diese Eigenschaft ist erforderlich, wenn Sie entweder eine quadratische oder eine breite Kachel erstellen.

PhoneticName

Ruft eine phonetische Version des sekundären Kachelnamens ab oder legt diese fest. Wird mit zeichenbasierten Sprachen für die Ui-Sortierung verwendet.

RoamingEnabled

Ruft einen Wert ab, der bestimmt, ob die sekundäre Kachel über die Cloud abgerufen wird, wenn die übergeordnete App vom Benutzer mithilfe seines Microsoft-Kontos auf einem anderen Computer installiert wird, oder legt diesen fest. Beachten Sie, dass ab Windows 8.1 roaming das Standardverhalten ist. Dies ist das Gegenteil des Standardverhaltens von Windows 8, bei dem Roaming aktiviert war.

Diese Eigenschaft gibt auf Windows Phone 8.1 immer false zurück.

ShortName

Hinweis

ShortName kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.DisplayName.

Ruft einen kurzen Namen ab, der direkt auf der Kachel angezeigt werden soll, oder legt diesen fest.

Hinweis

Ab Windows 8.1 wird diese Eigenschaft ignoriert, und der im Manifest deklarierte Anzeigename wird an seiner Stelle verwendet.

SmallLogo

Hinweis

SmallLogo kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTileVisualElements.Square30x30Logo.

Ruft das kleine Logobild ab, das in Suchergebnissen, der Liste Alle Programme und anderen Speicherorten auf der Benutzeroberfläche verwendet wird, oder legt es fest.

Das kleine Logo wird nicht mit einer sekundären Kachel Windows Phone 8.1 verwendet.

TileId

Ruft eine eindeutige Zeichenfolge ab, um die Kachel im Paket zu identifizieren, oder legt diese fest. Diese Eigenschaft ist erforderlich, wenn Sie eine Kachel erstellen oder löschen.

TileOptions

Hinweis

TileOptions können für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTile.VisualElements.

Ruft optionen ab, die für eine sekundäre Kachel verfügbar sind, oder legt diese fest.

VisualElements

Ruft ein Objekt ab, über das Sie die Hintergrundfarbe, den Vordergrundtext, die Kachelbilder und die Anzeigeoptionen für den App-Namen einer sekundären Kachel abrufen oder festlegen können. Ab Windows 8.1 ersetzen die Eigenschaften dieses Objekts diese SecondaryTile-Eigenschaften:

WideLogo

Hinweis

WideLogo kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen SecondaryTileVisualElements.Wide310x150Logo.

Ruft das Logobild ab, das in einer breit angelegten sekundären Kachel verwendet wird, oder legt es fest. Diese Eigenschaft ist erforderlich, wenn Sie eine breite sekundäre Kachel erstellen und dem Benutzer die Option einer breiten Kachel bietet, wenn er die Größe der Kachel ändert.

Methoden

Exists(String)

Überprüft, ob eine bestimmte sekundäre Kachel für die aufrufende App vorhanden ist.

FindAllAsync()

Ruft eine Liste mit sekundären Kacheln ab, die für die aufrufende App erstellt wurden.

FindAllAsync(String)

Ruft eine Liste der sekundären Kacheln ab, die für eine andere App im selben Paket wie die aufrufende App erstellt wurden.

FindAllForPackageAsync()

Ruft eine Liste der sekundären Kacheln ab, die für alle Apps im Paket der aufrufenden App erstellt wurden.

Wenn eine App gestartet wird, sollte sie immer ihre sekundären Kacheln über diese Methode auflisten, falls es Ergänzungen oder Löschungen gab, von denen sie nichts wusste. Wenn eine sekundäre Kachel über die Startbildschirm-App-Leiste gelöscht wird, entfernt Windows einfach die Kachel. Die App selbst ist für die Freigabe aller Ressourcen verantwortlich, die von der sekundären Kachel verwendet wurden. Wenn sekundäre Kacheln durch die Cloud kopiert werden, werden aktuelle Kachel- oder Signalbenachrichtigungen auf der sekundären Kachel, geplante Benachrichtigungen, Pushbenachrichtigungskanäle und Uniform Resource Identifier (URI), die mit regelmäßigen Benachrichtigungen verwendet werden, nicht mit der sekundären Kachel kopiert und müssen zurückgesetzt werden.

RequestCreateAsync()

Zeigt das Flyout An Start anheften an, über das der Benutzer bestätigen kann, dass er die sekundäre Kachel erstellen möchte, wodurch wiederum die Kachel erstellt wird. Mit Überladungen dieser Methode können Sie den Speicherort des Flyouts auf dem Bildschirm angeben.

Hinweis

Es empfiehlt sich, das Flyout An Start anheften in der Nähe der Schaltfläche anzuzeigen, die die Anforderung zum Erstellen der Kachel aufgerufen hat. Daher wird empfohlen, die RequestCreateAsync(Point) -Form dieser Methodenüberladung zu verwenden.

Unter Windows Phone 8.1 wird die sekundäre Kachel über diesen Aufruf erstellt, ohne dem Benutzer ein Flyout anzuzeigen, ihn zur Bestätigung aufzufordern oder die Auswahl einer Kachelgröße oder eines Titeltexts zuzulassen. Beachten Sie, dass bei Verwendung der RequestCreateAsync-Methode zum Anheften einer sekundären Kachel in Windows Phone 8.x-App die App angehalten und der Benutzer zum Startbildschirm weitergeleitet wird. Derselbe API-Aufruf auf einem PC setzt das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.

RequestCreateAsync(Point)

Zeigt das Flyout An Start an einem angegebenen Speicherort anheften an, über dem der Benutzer bestätigen kann, dass er die sekundäre Kachel erstellen möchte, wodurch wiederum die Kachel erstellt wird.

Unter Windows Phone 8.1 wird die sekundäre Kachel über diesen Aufruf erstellt, ohne dem Benutzer ein Flyout anzuzeigen, ihn zur Bestätigung aufzufordern oder die Auswahl einer Kachelgröße oder eines Titeltexts zuzulassen. Beachten Sie, dass bei Verwendung der RequestCreateAsync-Methode zum Anheften einer sekundären Kachel in Windows Phone 8.x-App die App angehalten und der Benutzer zum Startbildschirm weitergeleitet wird. Derselbe API-Aufruf auf einem PC setzt das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.

RequestCreateForSelectionAsync(Rect)

Zeigt das Flyout An Start anheften über einem angegebenen Bereich an. Dieses Flyout wird vom Benutzer verwendet, um zu bestätigen, dass er die sekundäre Kachel erstellen möchte, wodurch wiederum die Kachel erstellt wird.

Unter Windows Phone 8.1 wird die sekundäre Kachel über diesen Aufruf erstellt, ohne dem Benutzer ein Flyout anzuzeigen, ihn zur Bestätigung aufzufordern oder die Auswahl einer Kachelgröße oder eines Titeltexts zuzulassen. Beachten Sie, dass bei Verwendung der RequestCreateAsync-Methode zum Anheften einer sekundären Kachel in Windows Phone 8.x-App die App angehalten und der Benutzer zum Startbildschirm weitergeleitet wird. Derselbe API-Aufruf auf einem PC setzt das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.

RequestCreateForSelectionAsync(Rect, Placement)

Zeigt das Flyout An Start anheften an der angegebenen Seite eines angegebenen Bereichs an. Dieses Flyout wird vom Benutzer verwendet, um zu bestätigen, dass er die sekundäre Kachel erstellen möchte, wodurch wiederum die Kachel erstellt wird.

Unter Windows Phone 8.1 wird die sekundäre Kachel über diesen Aufruf erstellt, ohne dem Benutzer ein Flyout anzuzeigen, ihn zur Bestätigung aufzufordern oder die Auswahl einer Kachelgröße oder eines Titeltexts zuzulassen. Beachten Sie, dass bei Verwendung der RequestCreateAsync-Methode zum Anheften einer sekundären Kachel in Windows Phone 8.x-App die App angehalten und der Benutzer zum Startbildschirm weitergeleitet wird. Derselbe API-Aufruf auf einem PC setzt das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.

RequestDeleteAsync()

Zeigt das Flyout Vom Start lösen an. Mit diesem Flyout kann der Benutzer das Entfernen der sekundären Kachel bestätigen.

RequestDeleteAsync(Point)

Zeigt das Flyout Vom Start entfernen an einem angegebenen Punkt an. Mit diesem Flyout kann der Benutzer das Entfernen der sekundären Kachel bestätigen.

RequestDeleteForSelectionAsync(Rect)

Zeigt das Flyout Vom Start entfernen über einem angegebenen Bereich an. Mit diesem Flyout kann der Benutzer das Entfernen der sekundären Kachel bestätigen.

RequestDeleteForSelectionAsync(Rect, Placement)

Zeigt das Flyout Vom Start lösen auf der angegebenen Seite eines angegebenen Bereichs an. Mit diesem Flyout kann der Benutzer das Entfernen der sekundären Kachel bestätigen.

UpdateAsync()

Updates eine sekundäre Kachel, nachdem diese Kachel an den Startbildschirm angeheftet ist.

Bei Windows Phone 8.1 wird Ihre App angehalten, und der Benutzer wird zum Startbildschirm weitergeleitet, wenn eine sekundäre Kachel angeheftet ist. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert wird, dass er ausgeführt wird, bevor die App angehalten wird. Um dieses potenzielle Problem zu vermeiden, sollten Sie das OnSuspended-Ereignis Ihrer App verwenden, um Code auszuführen, z. B. das Aktualisieren der angehefteten Kachel, der ausgeführt werden sollte, bevor die App angehalten wird. Um ein Beispiel für dieses Muster anzuzeigen, laden Sie das Beispiel Kachelupdate beim Anhalten herunter, und führen Sie es aus.

Ereignisse

VisualElementsRequested

Wird ausgelöst, wenn ein Aufruf von RequestCreateAsync erfolgt.

Dieses Ereignis wird in Windows Phone 8.1 nicht ausgelöst.

Gilt für:

Weitere Informationen