PopupMenu Classe

Definizione

Spazio dei nomi:

Windows.UI.Popups

Rappresenta un menu di scelta rapida.

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da 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

Ereditarietà

Object Platform::Object IInspectable PopupMenu

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Fornire agli utenti un menu di scelta rapida aggiungendo un listener di eventi per l'evento "contextmenu" . Ad esempio, l'esempio di menu di scelta rapida è in ascolto dell'evento su elementi HTML specifici e quindi chiama la scenario1AttachmentHandler funzione.

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

Per personalizzare il menu di scelta rapida, chiamare preventDefault sull'evento per eliminare il valore predefinito e quindi creare un nuovo menu di scelta rapida vuoto, come illustrato nell'esempio di menu di scelta rapida.

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

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

Commenti

Un menu di scelta rapida può visualizzare un massimo di sei comandi. Questo limite consente di garantire che il menu di scelta rapida rimanga disordinato, utilizzabile e direttamente rilevante per gli utenti.

È possibile visualizzare esempi di codice completi che illustrano come creare e personalizzare il menu di scelta rapida nell'esempio di menu di scelta rapida (Windows 10) e nell'esempio di menu di scelta rapida (Windows 8.1).)

Per le applicazioni desktop basate su XAML, è consigliabile usare un riquadro a comparsa del menu per implementare i menu di scelta rapida.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreading (.NET).

Costruttori

PopupMenu()

Crea una nuova istanza della classe PopupMenu . In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Proprietà

Commands

Ottiene i comandi per il menu di scelta rapida.

Metodi

ShowAsync(Point)	Mostra il menu di scelta rapida in corrispondenza delle coordinate client specificate.
ShowForSelectionAsync(Rect)	Mostra il menu di scelta rapida sopra la selezione specificata.
ShowForSelectionAsync(Rect, Placement)	Mostra il menu di scelta rapida nel posizionamento preferito rispetto alla selezione specificata.

Vedi anche

• Commands
• UICommand
• UICommandSeparator
• Aggiunta di menu di scelta rapida
• Esempio di menu di scelta rapida
• Esempio di menu di scelta rapida (Windows 10)
• Menu e menu di scelta rapida per le app desktop
• Visualizzare oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow