SecondaryTile.RequestCreateAsync 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
| 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 die Position 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 Form RequestCreateAsync(Point) dieser Methodenüberladung zu verwenden.
|
| RequestCreateAsync(Point) |
Zeigt das Flyout An Start anheften über einer angegebenen Position an, über die der Benutzer bestätigen kann, dass er die sekundäre Kachel erstellen möchte, wodurch wiederum die Kachel erstellt wird.
|
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 die Position 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 Form RequestCreateAsync(Point) dieser Methodenüberladung zu verwenden.
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> ^ RequestCreateAsync() = RequestCreateAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
IAsyncOperation<bool> RequestCreateAsync();[Windows.Foundation.Metadata.Overload("RequestCreateAsync")]
public IAsyncOperation<bool> RequestCreateAsync();function requestCreateAsync()Public Function RequestCreateAsync () As IAsyncOperation(Of Boolean)Gibt zurück
Ein Objekt, das zum Starten des asynchronen Erstellungsvorgangs und zum Abrufen von Informationen dazu verwendet wird.
- Attribute
Hinweise
Nachdem eine sekundäre Kachel erstellt wurde, müssen Sie die folgenden Eigenschaften angeben, bevor sie angezeigt wird:
Diese Methode gibt einen asynchronen booleschen Wert über das IAsyncOperation-Objekt zurück, wie hier gezeigt. Der Wert true gibt an, dass die sekundäre Kachel erstellt und an den Startbildschirm angeheftet wurde.
async void showTileCreateRequest( SecondaryTile tile )
{
bool isPinned = await tile.requestCreateAsync();
}
Gilt für:
RequestCreateAsync(Point)
Zeigt das Flyout An Start anheften über einer angegebenen Position an, über die der Benutzer bestätigen kann, 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> ^ RequestCreateAsync(Point invocationPoint) = RequestCreateAsync;/// [Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
IAsyncOperation<bool> RequestCreateAsync(Point const& invocationPoint);[Windows.Foundation.Metadata.Overload("RequestCreateAsyncWithPoint")]
public IAsyncOperation<bool> RequestCreateAsync(Point invocationPoint);function requestCreateAsync(invocationPoint)Public Function RequestCreateAsync (invocationPoint As Point) As IAsyncOperation(Of Boolean)Parameter
- invocationPoint
- Point
Der Punkt, der als untere rechte Ecke des Flyouts An Start anheften verwendet wird.
Gibt zurück
Ein -Objekt, das Informationen zum asynchronen Erstellungsvorgang bereitstellt.
- Attribute