SecondaryTile.RequestCreateAsync 方法

定义

命名空间:

Windows.UI.StartScreen

重载

RequestCreateAsync()

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

RequestCreateAsync(Point)

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

RequestCreateAsync()

显示 “固定到'开始'屏幕” 浮出控件，用户可通过该浮出控件确认他们想要创建辅助磁贴，从而创建磁贴。 此方法的重载使你可以指定浮出控件的屏幕位置。

注意

最佳做法是在调用创建磁贴的请求的按钮附近显示“ 固定到开始” 菜单浮出控件。 因此，建议使用此方法重载的 RequestCreateAsync (Point) 形式。

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