PopupMenu クラス

リファレンス

定義

名前空間:: Windows.UI.Popups

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

コンテキストメニューを表します。

デスクトップアプリでは、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

属性: 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();

注釈

コンテキストメニューには、最大 6 つのコマンドを表示できます。この制限は、コンテキストメニューが整理され、使用可能であり、ユーザーに直接関連していることを確認するのに役立ちます。

コンテキストメニューのサンプル (Windows 10) とコンテキストメニューサンプル (Windows 8.1) でコンテキストメニューを作成およびカスタマイズする方法を示す完全なコード例を確認できます。

XAML ベースのデスクトップアプリケーションの場合は、メニューポップアップを使用してコンテキストメニューを実装することをお勧めします。

注意

このクラスはアジャイルではありません。つまり、スレッドモデルとマーシャリング動作を考慮する必要があります。詳細については、「スレッド処理とマーシャリング (C++/CX)」および「マルチスレッド環境での Windows ランタイムオブジェクトの使用 (.NET)」を参照してください。

コンストラクター

PopupMenu()

PopupMenu クラスの新しいインスタンスを作成します。

プロパティ

Commands

コンテキストメニューのコマンドを取得します。

メソッド

ShowAsync(Point)	指定したクライアント座標のコンテキストメニューを表示します。
ShowForSelectionAsync(Rect)	指定した選択範囲の上にコンテキストメニューが表示されます。
ShowForSelectionAsync(Rect, Placement)	指定した選択範囲を基準にして、優先配置のコンテキストメニューを表示します。

適用対象