SecondaryTile.RequestCreateForSelectionAsync 方法

定义

命名空间:

Windows.UI.StartScreen

重载

RequestCreateForSelectionAsync(Rect)	在指定区域上方显示“ 固定到开始”菜单 浮出控件。 用户使用此浮出控件来确认他们想要创建辅助磁贴，而辅助磁贴又会创建该磁贴。 在 Windows Phone 8.1 上，辅助磁贴是通过此调用创建的，而不会向用户显示浮出控件、提示用户进行确认或允许他们选择磁贴大小或标题文本。 请注意，使用 RequestCreateAsync 方法在 Windows Phone 8.x 应用中固定辅助磁贴时，应用将暂停，用户将转到“开始”屏幕。 电脑上的同一 API 调用不会暂停程序。 因此，请注意，在 RequestCreateAsync 之后调用的任何代码都不能保证在应用暂停之前运行。 若要避免此潜在问题，应使用应用的 OnSuspended 事件来运行应在应用暂停之前运行的任何代码，例如更新固定磁贴。 若要查看此模式的示例，请下载并运行 暂停时磁贴更新示例。
RequestCreateForSelectionAsync(Rect, Placement)	在指定区域的指定侧显示 “固定到开始”菜单 浮出控件。 用户使用此浮出控件来确认他们想要创建辅助磁贴，而辅助磁贴又会创建该磁贴。 在 Windows Phone 8.1 上，辅助磁贴是通过此调用创建的，而不会向用户显示浮出控件、提示用户进行确认或允许他们选择磁贴大小或标题文本。 请注意，使用 RequestCreateAsync 方法在 Windows Phone 8.x 应用中固定辅助磁贴时，应用将暂停，用户将转到“开始”屏幕。 电脑上的同一 API 调用不会暂停程序。 因此，请注意，在 RequestCreateAsync 之后调用的任何代码都不能保证在应用暂停之前运行。 若要避免此潜在问题，应使用应用的 OnSuspended 事件来运行应在应用暂停之前运行的任何代码，例如更新固定磁贴。 若要查看此模式的示例，请下载并运行 暂停时磁贴更新示例。

RequestCreateForSelectionAsync(Rect)

在指定区域上方显示“ 固定到开始”菜单 浮出控件。 用户使用此浮出控件来确认他们想要创建辅助磁贴，而辅助磁贴又会创建该磁贴。

在 Windows Phone 8.1 上，辅助磁贴是通过此调用创建的，而不会向用户显示浮出控件、提示用户进行确认或允许他们选择磁贴大小或标题文本。 请注意，使用 RequestCreateAsync 方法在 Windows Phone 8.x 应用中固定辅助磁贴时，应用将暂停，用户将转到“开始”屏幕。 电脑上的同一 API 调用不会暂停程序。 因此，请注意，在 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
• arguments
• SecondaryTileVisualElements.Square150x150Logo

RequestCreateForSelectionAsync(Rect, Placement)

在指定区域的指定侧显示 “固定到开始”菜单 浮出控件。 用户使用此浮出控件来确认他们想要创建辅助磁贴，而辅助磁贴又会创建该磁贴。

在 Windows Phone 8.1 上，辅助磁贴是通过此调用创建的，而不会向用户显示浮出控件、提示用户进行确认或允许他们选择磁贴大小或标题文本。 请注意，使用 RequestCreateAsync 方法在 Windows Phone 8.x 应用中固定辅助磁贴时，应用将暂停，用户将转到“开始”屏幕。 电脑上的同一 API 调用不会暂停程序。 因此，请注意，在 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