SecondaryTile.RequestCreateAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| RequestCreateAsync() |
显示 “固定到'开始'屏幕” 浮出控件，用户可通过该浮出控件确认他们想要创建辅助磁贴，从而创建磁贴。 此方法的重载使你可以指定浮出控件的屏幕位置。 注意 最佳做法是在调用创建磁贴的请求的按钮附近显示“ 固定到开始” 菜单浮出控件。 因此，建议使用此方法重载的 RequestCreateAsync (Point) 形式。
|
| RequestCreateAsync(Point) |
在指定位置上方显示 “固定到'开始'屏幕” 浮出控件，用户可通过该浮出控件确认他们想要创建辅助磁贴，从而创建该磁贴。
|
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 对象返回异步布尔值，如下所示。 值为 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
用作“ 固定到开始”菜单 浮出控件右下角的点。
返回
一个 对象，提供有关异步创建操作的信息。
- 属性