PopupMenu 類別

定義

表示操作功能表。

在傳統型應用程式中,在以顯示 UI 的方式使用這個類別的實例之前,您必須將物件與其擁有者的視窗控制碼產生關聯。 如需詳細資訊和程式碼範例,請參閱 顯示相依于 CoreWindow 的 WinRT UI 物件

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 PopupMenu
function PopupMenu()
Public NotInheritable Class PopupMenu
繼承
Object Platform::Object IInspectable PopupMenu
屬性

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

藉由新增事件的事件接聽程式 "contextmenu" ,為使用者提供操作功能表。 例如, 操作功能表範例 會接聽特定 HTML 元素上的事件,然後呼叫 函 scenario1AttachmentHandler 式。

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

若要自訂操作功能表,請在事件上呼叫 preventDefault 來隱藏預設值,然後建立新的空白操作功能表,如操作 功能表範例所示。

e.preventDefault(); // Prevent the default context menu.
var menu = new Windows.UI.Popups.PopupMenu();

備註

操作功能表最多可以顯示六個命令。 此限制有助於確保操作功能表維持不整齊、可用且直接與使用者相關。

您可以看到完整的程式碼範例,示範如何在操作功能表範例中建立和自訂操作功能表 (Windows 10) 和操作功能表範例 (Windows 8.1)

針對 XAML 型傳統型應用程式,我們建議 使用功能表飛出視窗來實作操作功能表

注意

這個類別不是敏捷式的,這表示您需要考慮其執行緒模型和封送處理行為。 如需詳細資訊,請參閱執行緒和封送處理 (C++/CX) 在多執行緒環境中使用 Windows 執行階段 物件 (.NET)

建構函式

PopupMenu()

建立 PopupMenu 類別的新實例。

在傳統型應用程式中,在以顯示 UI 的方式使用這個類別的實例之前,您必須將物件與其擁有者的視窗控制碼產生關聯。 如需詳細資訊和程式碼範例,請參閱 顯示相依于 CoreWindow 的 WinRT UI 物件

屬性

Commands

取得操作功能表的命令。

方法

ShowAsync(Point)

在指定的用戶端座標上顯示操作功能表。

ShowForSelectionAsync(Rect)

顯示指定選取範圍上方的操作功能表。

ShowForSelectionAsync(Rect, Placement)

顯示相對於指定選取範圍之慣用位置中的操作功能表。

適用於

另請參閱