SecondaryTile.RequestCreateAsync 方法

定義

命名空間:

Windows.UI.StartScreen

多載

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

IAsyncOperation<bool>

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

屬性

OverloadAttribute

備註

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

• tileId
• displayName
• 參數
• SecondaryTileVisualElements.Square150x150Logo

這個方法會透過其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

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

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

屬性

OverloadAttribute