Поделиться через


PopupMenu Класс

Определение

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

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

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

Свойства

Commands

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

Методы

ShowAsync(Point)

Отображает контекстное меню в указанных координатах клиента.

ShowForSelectionAsync(Rect)

Отображает контекстное меню над указанным выбранным элементом.

ShowForSelectionAsync(Rect, Placement)

Отображает контекстное меню в предпочтительном месте относительно указанного выбора.

Применяется к

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