SecondaryTile.RequestCreateForSelectionAsync メソッド

定義

名前空間:

Windows.UI.StartScreen

オーバーロード

RequestCreateForSelectionAsync(Rect)

指定した領域の上 に [スタート画面にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。 Windows Phone 8.1 では、ユーザーにポップアップを表示したり、確認を求めたり、タイル サイズやタイトル テキストを選択したりすることなく、この呼び出しによってセカンダリ タイルが作成されます。 RequestCreateAsync メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されます。 PC でのこの同じ API 呼び出しは、プログラムを中断しません。 そのため、 RequestCreateAsync の後に呼び出されたコードは、アプリが中断される前に実行される保証はされないことに注意してください。 この潜在的な問題を回避するには、アプリの OnSuspended イベントを使用して、アプリを中断する前に実行する必要があるコード (ピン留めされたタイルの更新など) を実行する必要があります。 このパターンの例を確認するには、 中断時のタイル更新のサンプルをダウンロードして実行します。

RequestCreateForSelectionAsync(Rect, Placement)

指定した領域の指定した側に [ 開始位置にピン留め する] ポップアップを表示します。 このポップアップは、ユーザーがセカンダリ タイルを作成することを確認するために使用され、タイルが作成されます。 Windows Phone 8.1 では、ユーザーにポップアップを表示したり、確認を求めたり、タイル サイズやタイトル テキストを選択したりすることなく、この呼び出しによってセカンダリ タイルが作成されます。 RequestCreateAsync メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されます。 PC でのこの同じ API 呼び出しは、プログラムを中断しません。 そのため、 RequestCreateAsync の後に呼び出されたコードは、アプリが中断される前に実行される保証はされないことに注意してください。 この潜在的な問題を回避するには、アプリの OnSuspended イベントを使用して、アプリを中断する前に実行する必要があるコード (ピン留めされたタイルの更新など) を実行する必要があります。 このパターンの例を確認するには、 中断時のタイル更新のサンプルをダウンロードして実行します。

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

ポップアップが真上に表示される領域。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

非同期作成操作に関する情報を提供する オブジェクト。

属性

OverloadAttribute

注釈

セカンダリ タイルが作成されたら、表示する前に次のプロパティを指定する必要があります。

• tileId
• displayName
• arguments
• SecondaryTileVisualElements.Square150x150Logo

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

ポップアップが表示される四角形の側面。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

非同期作成操作に関する情報を提供する オブジェクト。

属性

OverloadAttribute