Bagikan melalui


SecondaryTile Kelas

Definisi

Membuat, menghitung, dan menyediakan informasi tentang petak sekunder.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada coreWindow dan Menyematkan petak sekunder dari aplikasi desktop.

public ref class SecondaryTile sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
class SecondaryTile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.StartScreen.ISecondaryTileFactory2, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SecondaryTile final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SecondaryTile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.StartScreen.ISecondaryTileFactory2), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SecondaryTile
function SecondaryTile(tileId, shortName, displayName, arguments, tileOptions, logoReference, wideLogoReference)
Public NotInheritable Class SecondaryTile
Warisan
Object Platform::Object IInspectable SecondaryTile
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut membuat dan menyematkan petak sekunder ke layar Mulai.

using Windows.UI.StartScreen;

// Prepare package images for all four tile sizes in our tile to be pinned as well as for the square30x30 logo used in the Apps view.  
Uri square150x150Logo = new Uri("ms-appx:///Assets/square150x150Tile-sdk.png");
Uri wide310x150Logo = new Uri("ms-appx:///Assets/wide310x150Tile-sdk.png");
Uri square310x310Logo = new Uri("ms-appx:///Assets/square310x310Tile-sdk.png"); 
Uri square30x30Logo = new Uri("ms-appx:///Assets/square30x30Tile-sdk.png");

// During creation of secondary tile, an application may set additional arguments on the tile that will be passed in during activation.
// These arguments should be meaningful to the application. In this sample, we'll pass in the date and time the secondary tile was pinned.
string tileActivationArguments = MainPage.logoSecondaryTileId + " WasPinnedAt=" + DateTime.Now.ToLocalTime().ToString();

// Create a Secondary tile with all the required arguments.
// Note the last argument specifies what size the Secondary tile should show up as by default in the Pin to start fly out.
// It can be set to TileSize.Square150x150, TileSize.Wide310x150, or TileSize.Default.  
// If set to TileSize.Wide310x150, then the asset for the wide size must be supplied as well.
// TileSize.Default will default to the wide size if a wide size is provided, and to the medium size otherwise. 
SecondaryTile secondaryTile = new SecondaryTile(MainPage.logoSecondaryTileId,
                                                "Title text shown on the tile",
                                                tileActivationArguments,
                                                square150x150Logo,
                                                TileSize.Square150x150);

// Pin the tile
bool isPinned = await tile.RequestCreateAsync();
if (isPinned) {
    // Secondary tile successfully pinned.
} 
else {
    // Secondary tile not pinned.
}

Contoh berikut menunjukkan cara menghapus (melepas sematan) petak sekunder dengan menggunakan metode RequestDeleteAsync . Perhatikan bahwa contoh ini mengasumsikan bahwa petak peta ada. Untuk menentukan apakah petak peta disematkan sebelum Anda memanggil RequestDeleteAsync, lihat metode Exists .

// Check if the secondary tile is pinned
if (SecondaryTile.Exists(tileId)) {
    // Initialize a secondary tile with the same tile ID you want removed
    SecondaryTile toBeDeleted = new SecondaryTile(tileId);

    // And then unpin the tile
    bool isDeleted = await toBeDeleted.RequestDeleteAsync();
    if (isDeleted) {
        // Secondary tile successfully deleted.
    } else {
        // Secondary tile not deleted.
    }
}

Contoh berikut menunjukkan cara menggunakan metode FindAllForPackageAsync untuk mengambil daftar ID untuk semua petak sekunder yang dibuat untuk aplikasi panggilan dan aplikasi lain dalam paket yang sama.

// Get all secondary tiles
var tiles = await SecondaryTile.FindAllForPackageAsync();

Contoh berikut menunjukkan cara menggunakan metode TileUpdateManager.createTileUpdaterForSecondaryTile untuk mengirim pemberitahuan ke petak sekunder dengan ID "SecondaryTile.Dynamic". Perhatikan bahwa contoh menyediakan versi pemberitahuan yang lebar dan persegi karena pengguna memiliki kontrol atas bentuk petak peta mana yang ditampilkan.

using NotificationsExtensions.TileContent;

// Define the notification context.
// Note: This sample contains an additional reference, NotificationsExtensions, which you can use in your apps
ITileWide310x150Text04 tileContent = TileContentFactory.CreateTileWide310x150Text04();
tileContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationsExtensions!";

// Provide a square version of the notification.
ITileSquare150x150Text04 squareContent = TileContentFactory.CreateTileSquare150x150Text04();
squareContent.TextBodyWrap.Text = "Sent to a secondary tile from NotificationExtensions!";
tileContent.Square150x150Content = squareContent;

// Send the notification to the secondary tile by creating a secondary tile updater
TileUpdateManager.CreateTileUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(tileContent.CreateNotification());

Contoh berikut menunjukkan cara menggunakan metode BadgeUpdateManager.createBadgeUpdaterForSecondaryTile untuk mengirim pemberitahuan lencana numerik ke petak sekunder dengan ID "SecondaryTile.Dynamic".

using NotificationsExtensions.BadgeContent;

// Define the badge content
BadgeNumericNotificationContent badgeContent = new BadgeNumericNotificationContent(6);

// Send the notification to the secondary tile
BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile(MainPage.dynamicTileId).Update(badgeContent.CreateNotification());

Konstruktor

SecondaryTile()

Membuat objek SecondaryTile . Pemanggil kemudian harus mengatur properti wajib apa pun melalui objek sebelum mencoba menyematkan, memperbarui, atau menghapus ubin.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

SecondaryTile(String)

Membuat objek SecondaryTile dengan ID tertentu. Bentuk konstruktor ini harus digunakan untuk membuat objek petak peta sekunder untuk melakukan pembaruan atau penghapusan petak peta.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

SecondaryTile(String, String, String, String, TileOptions, Uri)

Catatan

Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize).

Membuat objek SecondaryTile sebagai petak peta sedang.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

SecondaryTile(String, String, String, String, TileOptions, Uri, Uri)

Catatan

Konstruktor ini dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.SecondaryTile(String, String, String, Uri, TileSize) dan berikan ukuran dan opsi petak lainnya melalui metode SecondaryTile.VisualElements .

Membuat objek SecondaryTile sebagai petak peta lebar.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

Di Windows Phone 8.1, semua petak peta—termasuk petak sekunder—disematkan sebagai petak peta sedang, setelah itu petak peta dapat diubah ukurannya oleh pengguna. Konstruktor ini menyediakan opsi untuk mengubah ukuran ke petak peta yang lebar.

SecondaryTile(String, String, String, Uri, TileSize)

Membuat objek SecondaryTile yang menyertakan semua properti wajib yang diperlukan untuk membuat petak peta sedang.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

Properti

Arguments

Mendapatkan atau mengatur sekumpulan informasi yang ditentukan aplikasi yang diteruskan dari petak peta sekunder ke aplikasi saat aktivasi. Properti ini diperlukan saat Anda membuat petak peta.

BackgroundColor

Catatan

BackgroundColor dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTileVisualElements.BackgroundColor.

Mendapatkan atau mengatur warna latar belakang petak peta.

DisplayName

Mendapatkan atau mengatur nama yang terkait dengan dan ditampilkan pada petak peta. Nama ini ditampilkan pada petak peta di Mulai, di tipsalat petak peta, di samping representasi petak peta kecil di daftar Aplikasi, dan di beberapa aplikasi Panel Kontrol. Properti ini diperlukan saat Anda membuat petak peta. Ini setara dengan nama tampilan yang dideklarasikan dalam manifes untuk petak utama aplikasi.

Pada Windows Phone 8.1, nama tampilan hanya ditampilkan pada petak peta sekunder lebar.

ForegroundText

Catatan

ForegroundText mungkin diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTileVisualElements.ForegroundText.

Mendapatkan atau mengatur apakah petak peta harus menggunakan teks gelap atau terang.

LockScreenBadgeLogo

Mendapatkan atau mengatur lokasi gambar logo lencana untuk mewakili petak sekunder pada layar kunci. Dengan menyediakan gambar ini, Anda menyatakan bahwa petak sekunder memenuhi syarat untuk menampilkan lencana pada layar kunci. Jika Anda juga ingin petak peta sekunder memenuhi syarat untuk slot petak peta terperinci layar kunci, Anda juga harus mengatur properti LockScreenDisplayBadgeAndTileText ke True.

Catatan

Menyatakan bahwa petak sekunder Anda memenuhi syarat untuk kehadiran layar kunci tidak menjamin bahwa petak tersebut akan memilikinya. Hanya pengguna yang dapat menambahkan aplikasi ke salah satu dari tujuh slot layar kunci. Untuk informasi selengkapnya, lihat Gambaran umum kunci layar.

LockScreenDisplayBadgeAndTileText

Mendapatkan atau mengatur apakah petak sekunder memenuhi syarat untuk menampilkan lencana dan petak peta terperinci pada layar kunci. Jika Anda mengatur properti ini ke True, Anda juga harus memberikan gambar lencana melalui properti LockScreenBadgeLogo . Jika Anda tidak ingin menggunakan kemampuan petak peta terperinci, berikan gambar lencana melalui properti LockScreenBadgeLogo dan atur LockScreenDisplayBadgeAndTileText ke False.

Catatan

Menyatakan bahwa petak sekunder Anda memenuhi syarat untuk kehadiran layar kunci tidak menjamin bahwa petak tersebut akan memilikinya. Hanya pengguna yang dapat menambahkan aplikasi ke salah satu dari tujuh slot layar kunci, serta memilih salah satu dari mereka yang dapat menampilkan informasi petak peta terperinci. Untuk informasi selengkapnya, lihat Gambaran umum kunci layar.

Logo

Catatan

Logo mungkin diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTileVisualElements.Square150x150Logo.

Mendapatkan atau mengatur gambar logo yang digunakan dalam petak peta sedang. Properti ini diperlukan saat Anda membuat ubin persegi atau lebar.

PhoneticName

Mendapatkan atau mengatur versi fonetik dari nama petak sekunder. Digunakan dengan bahasa berbasis karakter untuk tujuan pengurutan UI.

RoamingEnabled

Mendapatkan atau menetapkan nilai yang menentukan apakah petak sekunder akan diperoleh kembali melalui cloud saat aplikasi induk diinstal oleh pengguna, menggunakan akun Microsoft mereka, di komputer lain. Perhatikan bahwa pada Windows 8.1, roaming adalah perilaku default. Ini adalah kebalikan dari perilaku Windows 8 default, di mana roaming ikut serta.

Properti ini selalu mengembalikan false pada Windows Phone 8.1.

ShortName

Catatan

ShortName mungkin diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.DisplayName.

Mendapatkan atau mengatur nama pendek untuk ditampilkan langsung pada petak peta.

Catatan

Pada Windows 8.1, properti ini diabaikan dan nama tampilan yang dideklarasikan dalam manifes digunakan di tempatnya.

SmallLogo

Catatan

SmallLogo dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTileVisualElements.Square30x30Logo.

Mendapatkan atau mengatur gambar logo kecil, digunakan dalam hasil pencarian, daftar Semua Program, dan lokasi lain di UI.

Logo kecil tidak digunakan dengan petak sekunder Windows Phone 8.1.

TileId

Mendapatkan atau mengatur string unik untuk mengidentifikasi petak peta dalam paket. Properti ini diperlukan saat Anda membuat atau menghapus ubin.

TileOptions

Catatan

TileOptions dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTile.VisualElements.

Mendapatkan atau mengatur opsi yang tersedia untuk petak sekunder.

VisualElements

Mendapatkan objek tempat Anda bisa mendapatkan atau mengatur warna latar belakang petak sekunder, teks latar depan, gambar petak peta, dan opsi tampilan nama aplikasi. Pada Windows 8.1, properti objek ini menggantikan properti SecondaryTile ini:

WideLogo

Catatan

WideLogo dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan SecondaryTileVisualElements.Wide310x150Logo.

Mendapatkan atau mengatur gambar logo yang digunakan dalam petak peta sekunder yang lebar. Properti ini diperlukan saat Anda membuat petak peta sekunder lebar dan memberi pengguna opsi petak peta lebar saat mereka mengubah ukuran petak peta.

Metode

Exists(String)

Memeriksa apakah ada petak sekunder tertentu untuk aplikasi panggilan.

FindAllAsync()

Mengambil daftar petak sekunder yang dibuat untuk aplikasi panggilan.

FindAllAsync(String)

Mengambil daftar petak sekunder yang dibuat untuk aplikasi lain dalam paket yang sama dengan aplikasi panggilan.

FindAllForPackageAsync()

Mengambil daftar petak sekunder yang dibuat untuk semua aplikasi dalam paket aplikasi panggilan.

Ketika aplikasi diluncurkan, aplikasi harus selalu menghitung petak sekundernya melalui metode ini, jika ada penambahan atau penghapusan yang tidak diketahuinya. Saat petak sekunder dihapus melalui bilah aplikasi layar Mulai, Windows cukup menghapus petak peta. Aplikasi itu sendiri bertanggung jawab untuk merilis sumber daya apa pun yang digunakan oleh petak peta sekunder. Ketika petak sekunder disalin melalui cloud, pemberitahuan petak peta atau lencana saat ini pada petak sekunder, pemberitahuan terjadwal, saluran pemberitahuan push, dan Pengidentifikasi Sumber Daya Seragam (URI) yang digunakan dengan pemberitahuan berkala tidak disalin dengan petak sekunder dan harus disetel ulang.

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 to Start 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 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 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.

RequestCreateForSelectionAsync(Rect)

Menampilkan sematkan ke Mulai flyout di atas area yang ditentukan. Flyout ini digunakan oleh pengguna untuk 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 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.

RequestCreateForSelectionAsync(Rect, Placement)

Menampilkan sematkan ke Flyout Mulai di sisi area yang ditentukan. Flyout ini digunakan oleh pengguna untuk 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 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.

RequestDeleteAsync()

Menampilkan flyout Lepas dari Mulai . Flyout ini memungkinkan pengguna mengonfirmasi penghapusan petak sekunder.

RequestDeleteAsync(Point)

Menampilkan flyout Lepas dari Mulai pada titik tertentu. Flyout ini memungkinkan pengguna mengonfirmasi penghapusan petak sekunder.

RequestDeleteForSelectionAsync(Rect)

Menampilkan Flyout Lepas dari Mulai di atas area tertentu. Flyout ini memungkinkan pengguna mengonfirmasi penghapusan petak sekunder.

RequestDeleteForSelectionAsync(Rect, Placement)

Menampilkan Flyout Lepas dari Mulai di sisi area yang ditentukan. Flyout ini memungkinkan pengguna mengonfirmasi penghapusan petak sekunder.

UpdateAsync()

Updates petak sekunder setelah petak peta tersebut disematkan ke layar Mulai.

Di Windows Phone 8.1, aplikasi Anda ditangguhkan dan pengguna dibawa ke layar Mulai saat petak peta sekunder disematkan. 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.

Acara

VisualElementsRequested

Diaktifkan saat panggilan dilakukan ke RequestCreateAsync.

Kejadian ini tidak dinaikkan pada Windows Phone 8.1.

Berlaku untuk

Lihat juga