SecondaryTile.RequestCreateForSelectionAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| 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.
|
| 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.
|
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.
Auf 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 eine Kachelgröße oder einen Titeltext auszuwählen. 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 hält das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert 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 bei Angehalten herunter, und führen Sie es aus.
public:
virtual IAsyncOperation<bool> ^ RequestCreateForSelectionAsync(Rect selection) = RequestCreateForSelectionAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRect")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection);function requestCreateForSelectionAsync(selection)Public Function RequestCreateForSelectionAsync (selection As Rect) As IAsyncOperation(Of Boolean)Parameter
- selection
- Rect
Der Bereich, in dem das Flyout direkt oben angezeigt wird.
Gibt zurück
Ein -Objekt, das Informationen zum asynchronen Erstellungsvorgang bereitstellt.
- Attribute
Hinweise
Nachdem eine sekundäre Kachel erstellt wurde, müssen Sie die folgenden Eigenschaften angeben, bevor sie angezeigt wird:
Gilt für:
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.
Auf 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 eine Kachelgröße oder einen Titeltext auszuwählen. 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 hält das Programm nicht an. Beachten Sie daher, dass code, der nach RequestCreateAsync aufgerufen wird, nicht garantiert 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 bei Angehalten herunter, und führen Sie es aus.
public:
virtual IAsyncOperation<bool> ^ RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement) = RequestCreateForSelectionAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect const& selection, Placement const& preferredPlacement);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithRectAndPlacement")]
public IAsyncOperation<bool> RequestCreateForSelectionAsync(Rect selection, Placement preferredPlacement);function requestCreateForSelectionAsync(selection, preferredPlacement)Public Function RequestCreateForSelectionAsync (selection As Rect, preferredPlacement As Placement) As IAsyncOperation(Of Boolean)Parameter
- selection
- Rect
Der Bereich auf einer Seite, von dem das Flyout angezeigt wird.
- preferredPlacement
- Placement
Die Seite des Rechtecks, an der das Flyout angezeigt werden soll.
Gibt zurück
Ein -Objekt, das Informationen zum asynchronen Erstellungsvorgang bereitstellt.
- Attribute