PopupMenu.ShowAsync(Point) Metode

Referensi

Definisi

Ruang nama:: Windows.UI.Popups

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.

Edit

Memperlihatkan menu konteks pada koordinat klien yang ditentukan.

public:
 virtual IAsyncOperation<IUICommand ^> ^ ShowAsync(Point invocationPoint) = ShowAsync;

IAsyncOperation<IUICommand> ShowAsync(Point const& invocationPoint);

public IAsyncOperation<IUICommand> ShowAsync(Point invocationPoint);

function showAsync(invocationPoint)

Public Function ShowAsync (invocationPoint As Point) As IAsyncOperation(Of IUICommand)

Parameter

invocationPoint: Point

Koordinat (dalam DIP), relatif terhadap jendela, jari pengguna atau penunjuk mouse saat peristiwa oncontextmenu diaktifkan. Menu ditempatkan di atas dan berpusat pada titik ini.

Catatan

Untuk VB, C#, dan C++, jendela ini adalah CoreWindow yang terkait dengan utas yang memanggil menu konteks.

Mengembalikan

IAsyncOperation<IUICommand>

Objek IUICommand yang mewakili perintah menu konteks yang dipanggil oleh pengguna, setelah panggilan ShowAsync selesai.

Jika tidak ada perintah yang dipanggil, ShowAsync mengembalikan null.

Contoh

Sebelum dapat menampilkan menu konteks, Anda harus menambahkan pendengar peristiwa untuk peristiwa oncontextmenu . Misalnya, sampel menu Konteks mendengarkan peristiwa pada elemen HTML tertentu, lalu memanggil scenario1AttachmentHandler fungsi .

document.getElementById("attachment").addEventListener("contextmenu", attachmentHandler, false);

menu.commands.append(new Windows.UI.Popups.UICommand("Save attachment", onSaveAttachment));

// We don't want to obscure content, so pass in the position representing the selection area.
// We registered command callbacks; no need to handle the menu completion event
menu.showAsync(pageToWinRT(e.pageX, e.pageY)).then(function (invokedCommand) {
    if (invokedCommand === null) {
        // The command is null if no command was invoked.
        WinJS.log && WinJS.log("Context menu dismissed", "sample", "status");
    }
});

Selain itu, pastikan Anda memeriksa bahwa perintah dipanggil dan memproses kasus tersebut yang sesuai untuk aplikasi Anda. Jika UICommand yang dipanggil memiliki fungsi panggilan balik (onSaveAttachment dalam contoh), fungsi panggilan balik akan dijalankan. Jika tidak, Anda mungkin perlu menggunakan UICommand.Id untuk mengidentifikasi dan memproses perintah yang dipanggil.

Keterangan

Anda dapat melihat contoh kode lengkap yang menunjukkan cara membuat dan menyesuaikan menu konteks di sampel menu Konteks.

Berlaku untuk