共用方式為


SecondaryTile.RequestCreateAsync 方法

定義

多載

RequestCreateAsync()

顯示 [釘選到開始] 飛出視窗,使用者可以透過該飛出視窗確認他們想要建立次要磚,進而建立磚。 這個方法的多載可讓您指定飛出視窗的螢幕位置。

注意

最佳做法是在叫用要求來建立磚的按鈕附近顯示 [ 釘選到開始] 飛出視窗。 因此,建議您使用 RequestCreateAsync (Point) 形式的此方法多載。

在 Windows Phone 8.1 上,次要磚會透過此呼叫建立,而不會向使用者顯示飛出視窗、提示他們確認,或讓他們選擇磚大小或標題文字。 請注意,使用 RequestCreateAsync 方法在 Windows Phone 8.x 應用程式中釘選次要磚時,應用程式會暫停,並將使用者帶至 [開始] 畫面。 電腦上的這個相同 API 呼叫不會暫停程式。 因此請注意,在 App 暫停之前,不保證在 RequestCreateAsync 之後呼叫的任何程式碼都會執行。 若要避免此潛在問題,您應該使用應用程式的 OnSuspended 事件來執行任何程式碼,例如更新釘選的磚,應該在應用程式暫停之前執行。 若要查看此模式的範例,請下載並執行 暫止範例上的磚更新

RequestCreateAsync(Point)

顯示指定位置上方的 [釘選到開始] 飛出視窗,讓使用者可以透過該位置確認他們想要建立次要磚,進而建立磚。

在 Windows Phone 8.1 上,次要磚會透過此呼叫建立,而不會向使用者顯示飛出視窗、提示他們確認,或讓他們選擇磚大小或標題文字。 請注意,使用RequestCreateAsync方法在 Windows Phone 8.x 應用程式中釘選次要磚時,應用程式會暫停,並將使用者帶到 [開始] 畫面。 電腦上的這個相同 API 呼叫不會暫停程式。 因此請注意,在 App 暫停之前,不保證在 RequestCreateAsync 之後呼叫的任何程式碼都會執行。 若要避免此潛在問題,您應該使用應用程式的 OnSuspended 事件來執行任何程式碼,例如更新釘選的磚,應該在應用程式暫停之前執行。 若要查看此模式的範例,請下載並執行 暫止範例上的磚更新

RequestCreateAsync()

顯示 [釘選到開始] 飛出視窗,使用者可以透過該飛出視窗確認他們想要建立次要磚,進而建立磚。 這個方法的多載可讓您指定飛出視窗的螢幕位置。

注意

最佳做法是在叫用要求來建立磚的按鈕附近顯示 [ 釘選到開始] 飛出視窗。 因此,建議您使用 RequestCreateAsync (Point) 形式的此方法多載。

在 Windows Phone 8.1 上,次要磚會透過此呼叫建立,而不會向使用者顯示飛出視窗、提示他們確認,或讓他們選擇磚大小或標題文字。 請注意,使用 RequestCreateAsync 方法在 Windows Phone 8.x 應用程式中釘選次要磚時,應用程式會暫停,並將使用者帶至 [開始] 畫面。 電腦上的這個相同 API 呼叫不會暫停程式。 因此請注意,在 App 暫停之前,不保證在 RequestCreateAsync 之後呼叫的任何程式碼都會執行。 若要避免此潛在問題,您應該使用應用程式的 OnSuspended 事件來執行任何程式碼,例如更新釘選的磚,應該在應用程式暫停之前執行。 若要查看此模式的範例,請下載並執行 暫止範例上的磚更新

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)

傳回

用來啟動非同步建立作業的物件,以及擷取其相關資訊的物件。

屬性

備註

建立次要磚之後,您必須先提供下列屬性,才能顯示:

這個方法會透過其IAsyncOperation物件傳回非同步布林值,如下所示。 true值表示已建立次要磚並釘選到 [開始] 畫面。

async void showTileCreateRequest( SecondaryTile tile )  
{
    bool isPinned = await tile.requestCreateAsync();  
}

適用於

RequestCreateAsync(Point)

顯示指定位置上方的 [釘選到開始] 飛出視窗,讓使用者可以透過該位置確認他們想要建立次要磚,進而建立磚。

在 Windows Phone 8.1 上,次要磚會透過此呼叫建立,而不會向使用者顯示飛出視窗、提示他們確認,或讓他們選擇磚大小或標題文字。 請注意,使用RequestCreateAsync方法在 Windows Phone 8.x 應用程式中釘選次要磚時,應用程式會暫停,並將使用者帶到 [開始] 畫面。 電腦上的這個相同 API 呼叫不會暫停程式。 因此請注意,在 App 暫停之前,不保證在 RequestCreateAsync 之後呼叫的任何程式碼都會執行。 若要避免此潛在問題,您應該使用應用程式的 OnSuspended 事件來執行任何程式碼,例如更新釘選的磚,應該在應用程式暫停之前執行。 若要查看此模式的範例,請下載並執行 暫止範例上的磚更新

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)

參數

invocationPoint
Point

作為 [釘選到開始 ] 飛出視窗右下角的點。

傳回

物件,提供非同步建立作業的相關資訊。

屬性

適用於