PopupMenu Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class PopupMenu final/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class PopupMenu[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 PopupMenufunction PopupMenu()Public NotInheritable Class PopupMenu- Ereditarietà
- Attributi
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. |