SecondaryTile.RequestCreateAsync メソッド

定義

オーバーロード

RequestCreateAsync()

[ 開始にピン留めする ] ポップアップが表示されます。これにより、ユーザーはセカンダリ タイルを作成することを確認できます。これにより、タイルが作成されます。 このメソッドのオーバーロードを使用すると、ポップアップの画面上の場所を指定できます。

注意

タイルの作成要求を呼び出したボタンの近くに [ 開始にピン留め する] ポップアップを表示することをお勧めします。 そのため、このメソッド オーバーロードの RequestCreateAsync(Point) 形式を使用することをお勧めします。

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

RequestCreateAsync(Point)

指定した場所の上 に [開始にピン留めする ] ポップアップを表示します。これにより、ユーザーはセカンダリ タイルを作成することを確認できます。これにより、タイルが作成されます。

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

RequestCreateAsync()

[ 開始にピン留めする ] ポップアップが表示されます。これにより、ユーザーはセカンダリ タイルを作成することを確認できます。これにより、タイルが作成されます。 このメソッドのオーバーロードを使用すると、ポップアップの画面上の場所を指定できます。

注意

タイルの作成要求を呼び出したボタンの近くに [ 開始にピン留め する] ポップアップを表示することをお勧めします。 そのため、このメソッド オーバーロードの RequestCreateAsync(Point) 形式を使用することをお勧めします。

Windows Phone 8.1 では、ユーザーにポップアップを表示したり、確認を求めたり、タイル サイズやタイトル テキストを選択したりすることなく、この呼び出しによってセカンダリ タイルが作成されます。 RequestCreateAsync メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されることに注意してください。 PC でのこの同じ 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 メソッドを使用して 8.x アプリでセカンダリ タイルWindows Phoneピン留めすると、アプリは中断され、ユーザーは [スタート] 画面に表示されます。 PC でのこの同じ 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

[開始にピン留めする] ポップアップの右下隅として使用されるポイント。

戻り値

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

属性

適用対象