PopupMenu Kelas

Definisi

Ruang nama:

Windows.UI.Popups

Mewakili menu konteks.

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.

public ref class PopupMenu sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PopupMenu final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PopupMenu

function PopupMenu()

Public NotInheritable Class PopupMenu

Warisan

Object Platform::Object IInspectable PopupMenu

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Berikan menu konteks kepada pengguna dengan menambahkan pendengar peristiwa untuk acara tersebut "contextmenu" . Misalnya, sampel menu Konteks mendengarkan peristiwa pada elemen HTML tertentu, lalu memanggil scenario1AttachmentHandler fungsi .

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

Untuk menyesuaikan menu konteks, panggil preventDefault pada peristiwa untuk menekan default, lalu buat menu konteks baru yang kosong seperti yang ditunjukkan dalam sampel menu Konteks.

e.preventDefault(); // Prevent the default context menu.

var menu = new Windows.UI.Popups.PopupMenu();

Keterangan

Menu konteks dapat menampilkan maksimal enam perintah. Batas ini membantu memastikan bahwa menu konteks tetap tidak berantakan, dapat digunakan, dan relevan langsung dengan pengguna.

Anda dapat melihat contoh kode lengkap yang menunjukkan cara membuat dan menyesuaikan menu konteks di sampel menu Konteks (Windows 10) dan sampel menu Konteks (Windows 8.1).

Untuk aplikasi desktop berbasis XAML, sebaiknya gunakan flyout menu untuk menerapkan menu konteks.

Catatan

Kelas ini tidak lincah, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Konstruktor

PopupMenu()

Membuat instans baru kelas PopupMenu . 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

Commands

Mendapatkan perintah untuk menu konteks.

Metode

ShowAsync(Point)	Memperlihatkan menu konteks pada koordinat klien yang ditentukan.
ShowForSelectionAsync(Rect)	Memperlihatkan menu konteks di atas pilihan yang ditentukan.
ShowForSelectionAsync(Rect, Placement)	Memperlihatkan menu konteks dalam penempatan pilihan relatif terhadap pilihan yang ditentukan.

Lihat juga

• Commands
• UICommand
• UICommandSeparator
• Menambahkan menu konteks
• Sampel menu konteks
• Sampel menu konteks (Windows 10)
• Menu dan menu konteks untuk aplikasi desktop
• Menampilkan objek UI WinRT yang bergantung pada CoreWindow