SecondaryTile.RequestCreateAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.
|
| 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.
|
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