PopupMenu Класс

Определение

Пространство имен:

Windows.UI.Popups

Представляет контекстное меню.

В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от 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

Наследование

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 . В классическом приложении перед использованием экземпляра этого класса таким образом, который отображает пользовательский интерфейс, необходимо связать объект с дескриптором окна его владельца. Дополнительные сведения и примеры кода см. в разделе Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

Свойства

Commands

Возвращает команды для контекстного меню.

Методы

ShowAsync(Point)	Отображает контекстное меню в указанных координатах клиента.
ShowForSelectionAsync(Rect)	Отображает контекстное меню над указанным выбранным элементом.
ShowForSelectionAsync(Rect, Placement)	Отображает контекстное меню в предпочтительном месте относительно указанного выбора.

См. также раздел

• Commands
• UICommand
• UICommandSeparator
• Добавление контекстных меню
• Пример контекстного меню
• Пример контекстного меню (Windows 10)
• Меню и контекстные меню для классических приложений
• Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow