SecondaryTile.RequestCreateForSelectionAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| RequestCreateForSelectionAsync(Rect) |
指定した領域の上 に [スタート画面にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。
|
| RequestCreateForSelectionAsync(Rect, Placement) |
指定した領域の指定した側に [ 開始位置にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。
|
RequestCreateForSelectionAsync(Rect)
指定した領域の上 に [スタート画面にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。
Windows Phone 8.1 では、ユーザーにポップアップを表示したり、確認を求めたり、タイル サイズやタイトル テキストを選択したりすることなく、この呼び出しによってセカンダリ タイルが作成されます。 RequestCreateAsync メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されます。 PC でのこの同じ 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
ポップアップが真上に表示される領域。
戻り値
非同期作成操作に関する情報を提供する オブジェクト。
- 属性
注釈
セカンダリ タイルが作成されたら、表示する前に次のプロパティを指定する必要があります。
適用対象
RequestCreateForSelectionAsync(Rect, Placement)
指定した領域の指定した側に [ 開始位置にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。
Windows Phone 8.1 では、ユーザーにポップアップを表示したり、確認を求めたり、タイル サイズやタイトル テキストを選択したりすることなく、この呼び出しによってセカンダリ タイルが作成されます。 RequestCreateAsync メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されます。 PC でのこの同じ 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
ポップアップが表示される四角形の側面。
戻り値
非同期作成操作に関する情報を提供する オブジェクト。
- 属性