Bagikan melalui


SecondaryTile.RequestCreateAsync Metode

Definisi

Overload

RequestCreateAsync()

Menampilkan sematkan ke Mulai flyout, di mana pengguna dapat mengonfirmasi bahwa mereka ingin membuat petak sekunder, yang pada gilirannya membuat petak peta. Kelebihan beban metode ini memungkinkan Anda menentukan lokasi flyout di layar.

Catatan

Ini adalah praktik terbaik untuk menampilkan flyout Pin ke Mulai di dekat tombol yang memanggil permintaan untuk membuat petak peta. Oleh karena itu, kami sarankan Anda menggunakan bentuk RequestCreateAsync(Point) dari metode ini kelebihan beban.

Pada Windows Phone 8.1, petak sekunder dibuat melalui panggilan ini tanpa menampilkan flyout kepada pengguna, meminta mereka untuk konfirmasi, atau memungkinkan mereka memilih ukuran petak peta atau teks judul. Perhatikan bahwa saat menggunakan metode RequestCreateAsync untuk menyematkan petak sekunder di aplikasi Windows Phone 8.x, aplikasi ditangguhkan dan pengguna dibawa ke layar Mulai. Panggilan API yang sama pada PC ini tidak menangguhkan program. Oleh karena itu, ketahuilah bahwa kode apa pun yang dipanggil setelah RequestCreateAsync tidak dijamin akan dijalankan sebelum aplikasi ditangguhkan. Untuk menghindari potensi masalah ini, Anda harus menggunakan peristiwa OnSuspended aplikasi Anda untuk menjalankan kode apa pun, seperti memperbarui petak peta yang disematkan, yang harus dijalankan sebelum aplikasi ditangguhkan. Untuk melihat contoh pola ini, unduh dan jalankan pembaruan Petak peta pada sampel yang ditangguhkan.

RequestCreateAsync(Point)

Menampilkan sematkan ke Mulai flyout di atas lokasi tertentu, di mana pengguna dapat mengonfirmasi bahwa mereka ingin membuat petak sekunder, yang pada gilirannya membuat petak peta.

Pada Windows Phone 8.1, petak sekunder dibuat melalui panggilan ini tanpa menampilkan flyout kepada pengguna, meminta mereka untuk konfirmasi, atau memungkinkan mereka memilih ukuran petak peta atau teks judul. Perhatikan bahwa saat menggunakan metode RequestCreateAsync untuk menyematkan petak sekunder di aplikasi Windows Phone 8.x, aplikasi ditangguhkan dan pengguna dibawa ke layar Mulai. Panggilan API yang sama pada PC ini tidak menangguhkan program. Oleh karena itu, ketahuilah bahwa kode apa pun yang dipanggil setelah RequestCreateAsync tidak dijamin akan dijalankan sebelum aplikasi ditangguhkan. Untuk menghindari potensi masalah ini, Anda harus menggunakan peristiwa OnSuspended aplikasi Anda untuk menjalankan kode apa pun, seperti memperbarui petak peta yang disematkan, yang harus dijalankan sebelum aplikasi ditangguhkan. Untuk melihat contoh pola ini, unduh dan jalankan pembaruan Petak peta pada sampel yang ditangguhkan.

RequestCreateAsync()

Menampilkan sematkan ke Mulai flyout, di mana pengguna dapat mengonfirmasi bahwa mereka ingin membuat petak sekunder, yang pada gilirannya membuat petak peta. Kelebihan beban metode ini memungkinkan Anda menentukan lokasi flyout di layar.

Catatan

Ini adalah praktik terbaik untuk menampilkan flyout Pin ke Mulai di dekat tombol yang memanggil permintaan untuk membuat petak peta. Oleh karena itu, kami sarankan Anda menggunakan bentuk RequestCreateAsync(Point) dari metode ini kelebihan beban.

Pada Windows Phone 8.1, petak sekunder dibuat melalui panggilan ini tanpa menampilkan flyout kepada pengguna, meminta mereka untuk konfirmasi, atau memungkinkan mereka memilih ukuran petak peta atau teks judul. Perhatikan bahwa saat menggunakan metode RequestCreateAsync untuk menyematkan petak sekunder di aplikasi Windows Phone 8.x, aplikasi ditangguhkan dan pengguna dibawa ke layar Mulai. Panggilan API yang sama pada PC ini tidak menangguhkan program. Oleh karena itu, ketahuilah bahwa kode apa pun yang dipanggil setelah RequestCreateAsync tidak dijamin akan dijalankan sebelum aplikasi ditangguhkan. Untuk menghindari potensi masalah ini, Anda harus menggunakan peristiwa OnSuspended aplikasi Anda untuk menjalankan kode apa pun, seperti memperbarui petak peta yang disematkan, yang harus dijalankan sebelum aplikasi ditangguhkan. Untuk melihat contoh pola ini, unduh dan jalankan pembaruan Petak peta pada sampel yang ditangguhkan.

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)

Mengembalikan

Objek yang digunakan untuk meluncurkan operasi pembuatan asinkron serta untuk mengambil informasi tentangnya.

Atribut

Keterangan

Setelah petak peta sekunder dibuat, Anda harus menyediakan properti berikut sebelum ditampilkan:

Metode ini mengembalikan nilai Boolean asinkron melalui objek IAsyncOperation seperti yang ditunjukkan di sini. Nilai true menunjukkan bahwa petak sekunder dibuat dan disematkan ke layar Mulai.

async void showTileCreateRequest( SecondaryTile tile )  
{
    bool isPinned = await tile.requestCreateAsync();  
}

Berlaku untuk

RequestCreateAsync(Point)

Menampilkan sematkan ke Mulai flyout di atas lokasi tertentu, di mana pengguna dapat mengonfirmasi bahwa mereka ingin membuat petak sekunder, yang pada gilirannya membuat petak peta.

Pada Windows Phone 8.1, petak sekunder dibuat melalui panggilan ini tanpa menampilkan flyout kepada pengguna, meminta mereka untuk konfirmasi, atau memungkinkan mereka memilih ukuran petak peta atau teks judul. Perhatikan bahwa saat menggunakan metode RequestCreateAsync untuk menyematkan petak sekunder di aplikasi Windows Phone 8.x, aplikasi ditangguhkan dan pengguna dibawa ke layar Mulai. Panggilan API yang sama pada PC ini tidak menangguhkan program. Oleh karena itu, ketahuilah bahwa kode apa pun yang dipanggil setelah RequestCreateAsync tidak dijamin akan dijalankan sebelum aplikasi ditangguhkan. Untuk menghindari potensi masalah ini, Anda harus menggunakan peristiwa OnSuspended aplikasi Anda untuk menjalankan kode apa pun, seperti memperbarui petak peta yang disematkan, yang harus dijalankan sebelum aplikasi ditangguhkan. Untuk melihat contoh pola ini, unduh dan jalankan pembaruan Petak peta pada sampel yang ditangguhkan.

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)

Parameter

invocationPoint
Point

Titik yang digunakan sebagai sudut kanan bawah sematkan ke Flyout Mulai .

Mengembalikan

Objek yang menyediakan informasi tentang operasi pembuatan asinkron.

Atribut

Berlaku untuk