SecondaryTile.RequestCreateForSelectionAsync 方法

定義

命名空間:

Windows.UI.StartScreen

多載

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

RequestCreateForSelectionAsync(Rect)

顯示指定區域上方的 [釘選到開始] 飛出視窗。 此飛出視窗由使用者用來確認他們想要建立次要磚，進而建立磚。

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

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)

參數

selection

Rect

飛出視窗直接顯示在上方的區域。

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

屬性

OverloadAttribute

備註

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

• tileId
• displayName
• 參數
• SecondaryTileVisualElements.Square150x150Logo

RequestCreateForSelectionAsync(Rect, Placement)

顯示指定區域之指定端的 [釘選到開始] 飛出視窗。 此飛出視窗由使用者用來確認他們想要建立次要磚，進而建立磚。

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

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)

參數

selection

Rect

飛出視窗會顯示到其中一側的區域。

preferredPlacement

Placement

飛出視窗應該出現的矩形側邊。

傳回

IAsyncOperation<Boolean>

IAsyncOperation<bool>

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

屬性

OverloadAttribute