PopupMenu 類別

定義

命名空間:

Windows.UI.Popups

表示操作功能表。

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

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

繼承

Object Platform::Object IInspectable PopupMenu

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

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)	顯示相對於指定選取範圍之慣用位置中的操作功能表。

另請參閱

• Commands
• UICommand
• UICommandSeparator
• 新增操作功能表
• 操作功能表範例
• 操作功能表範例 (Windows 10)
• 傳統型應用程式的功能表和操作功能表
• 顯示相依于 CoreWindow 的 WinRT UI 物件