Настройка контекстных меню в WebView2

Элемент управления WebView2 предоставляет контекстное меню по умолчанию, и при использовании элемента управления WebView2 можно создать собственное контекстное меню. Используйте API ContextMenuRequested для настройки контекстных меню (контекстных меню) приложения WebView2. Например, можно выполнить любое из следующих действий:

• Добавление настраиваемого контекстного меню.

  Вместо использования контекстного меню по умолчанию ведущее приложение может нарисовать собственное контекстное меню, используя сведения, отправляемые из контекстного меню WebView2. Ваше приложение обрабатывает ContextMenuRequested событие. Данные, указанные в аргументах ContextMenuRequested Event, можно использовать для отображения настраиваемого контекстного меню с выбранными записями. В этом случае вы обрабатываете событие и запрашиваете отсрочку.

  В пользовательское контекстное меню можно добавить элементы меню по умолчанию и (или) настраиваемые элементы меню.

• Добавление элементов меню по умолчанию в пользовательское контекстное меню.

• Добавление настраиваемых элементов меню в контекстное меню по умолчанию.

• Удалите элементы по умолчанию или настраиваемые элементы меню из контекстного меню по умолчанию.

• Отключить контекстные меню.

Терминологии:

Термин	Определение
пункт меню	Широкий термин. Включает флажок, команду, переключатель, разделитель и подменю.
Команды	Узкий термин. Один из пяти типов элементов меню.
контекстное меню	Контекстное меню по умолчанию (контекстное меню), принадлежащее элементу управления WebView2, или пользовательское контекстное меню (контекстное меню), принадлежащее ведущему приложению.

Добавление настраиваемого контекстного меню

Вместо использования контекстного меню по умолчанию ведущее приложение может нарисовать собственное контекстное меню, используя сведения, отправляемые из контекстного меню WebView2. Ваше приложение обрабатывает ContextMenuRequested событие. Данные, указанные в аргументах ContextMenuRequested Event, можно использовать для отображения настраиваемого контекстного меню с выбранными записями. В этом случае вы обрабатываете событие и запрашиваете отсрочку.

Когда пользователь выбирает команду в пользовательском контекстном меню, приложение должно сообщить элементу управления WebView2, какую команду выбрал пользователь, используя SelectedCommandId свойство .

В пользовательское контекстное меню можно добавить элементы меню по умолчанию и (или) настраиваемые элементы меню.

C#

Чтобы отобразить пользовательское контекстное меню, содержащее нужные элементы меню, используйте данные, указанные CoreWebView2ContextMenuRequestedEventArgsCoreWebView2 в объекте ContextMenuRequested Event. В этом случае необходимо указать Handledtrueзначение и запросить отсрочку.

В событии CoreWebView2.ContextMenuRequested добавьте прослушиватель событий с CoreWebView2ContextMenuRequestedEventArgs.

Свойство MenuItems предоставляет CoreWebView2ContextMenuRequestedEventArgs дерево элементов контекстного меню WebView2 для контекста, щелкнув его правой кнопкой мыши. Чтобы включить элементы контекстного меню WebView2 в контекстное меню приложения, выполните итерацию по IList<CoreWebView2ContextMenuItem>, добавив CoreWebView2ContextMenuItem для каждого пункта меню. .Kind Протестируйте каждый элемент меню, например Command или Separator.

• Класс CoreWebView2

  • Событие ContextMenuRequested

• Класс CoreWebView2ContextMenuItem

  • Свойство Children
  • Свойство CommandId
  • Свойство IsChecked
  • Свойство IsEnabled
  • Свойство Kind
  • Свойство Label
  • Свойство ShortcutKeyDescription

• Класс CoreWebView2ContextMenuRequestedEventArgs

  • Свойство ContextMenuTarget
  • Обработанное свойство
  • Свойство MenuItems
  • Свойство SelectedCommandId
  • Метод GetDeferral

• Перечисление CoreWebView2ContextMenuItemKind

  • CoreWebView2ContextMenuItemKind.Command
  • CoreWebView2ContextMenuItemKind.Separator

• Перечисление CoreWebView2ContextMenuTargetKind

• Класс CoreWebView2Deferral

  • Метод Complete

• Перечисление CoreWebView2ContextMenuItemKind

  • CheckBox
  • Radio
  • Separator
  • Submenu

C++

Чтобы отобразить пользовательское контекстное меню, содержащее нужные элементы меню, используйте данные, указанные в ICoreWebView2ContextMenuRequestedEventArgs. В этом случае необходимо указать Handledtrueзначение и запросить отсрочку.

ContextMenuRequested Для события добавьте прослушиватель событий с ICoreWebView2ContextMenuRequestedEventArgs.

Выполните итерацию по списку ICoreWebView2ContextMenuItem элементов, добавляя для ICoreWebView2ContextMenuItem каждого элемента меню. COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND Протестируйте каждый элемент меню, например COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR или COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND.

• ICoreWebView2_11

  • add_ContextMenuRequested
  • remove_ContextMenuRequested

• ICoreWebView2ContextMenuItem

  • get_Children
  • get_CommandId
  • get_IsChecked
  • get_IsEnabled
  • get_Kind
  • get_Label
  • get_ShortcutKeyDescription

• ICoreWebView2ContextMenuItemCollection

  • get_Count
  • GetValueAtIndex

• ICoreWebView2ContextMenuRequestedEventArgs

  • get_MenuItems
  • get_Location
  • GetDeferral
  • put_Handled
  • put_SelectedCommandId

• ICoreWebView2ContextMenuRequestedEventHandler

• ICoreWebView2Deferral

• перечисление COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND

  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SUBMENU

• перечисление COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND

Пример. Добавление пользовательского контекстного меню

В следующем примере представлено контекстное меню WebView2 в формате контекстного меню Win32/WPF.

C#

webView.CoreWebView2.ContextMenuRequested += delegate (object sender, 
                                    CoreWebView2ContextMenuRequestedEventArgs args)
{
    IList<CoreWebView2ContextMenuItem> menuList = args.MenuItems;
    CoreWebView2Deferral deferral = args.GetDeferral();
    args.Handled = true;
    ContextMenu cm = new ContextMenu();
    cm.Closed += (s, ex) => deferral.Complete();
    PopulateContextMenu(args, menuList, cm);
    cm.IsOpen = true;
};
void PopulateContextMenu(CoreWebView2ContextMenuRequestedEventArgs args, 
IList<CoreWebView2ContextMenuItem> menuList, ItemsControl cm)
{
    for (int i = 0; i < menuList.Count; i++)
    {
        CoreWebView2ContextMenuItem current = menuList[i];
        if (current.Kind == CoreWebView2ContextMenuItemKind.Separator)
        {
            Separator sep = new Separator();
            cm.Items.Add(sep);
            continue;
        }
        MenuItem newItem = new MenuItem();
        // The accessibility key is the key after the & in the label
        // Replace with '_' so it is underlined in the label
        newItem.Header = current.Label.Replace('&', '_');
        newItem.InputGestureText = current.ShortcutKeyDescription;
        newItem.IsEnabled = current.IsEnabled;
        if (current.Kind == CoreWebView2ContextMenuItemKind.Submenu)
        {
            PopulateContextMenu(args, current.Children, newItem);
        }
        else
        {
            if (current.Kind == CoreWebView2ContextMenuItemKind.CheckBox
            || current.Kind == CoreWebView2ContextMenuItemKind.Radio)
            {
                newItem.IsCheckable = true;
                newItem.IsChecked = current.IsChecked;
            }

            newItem.Click += (s, ex) =>
            {
                args.SelectedCommandId = current.CommandId;
            };
        }
        cm.Items.Add(newItem);
    }
}

C++

m_webView2_4 = m_webView.try_query<ICoreWebView2_4>();
webview2_4->add_ContextMenuRequested(
    Callback<ICoreWebView2ContextMenuRequestedEventHandler>(
        [this](
            ICoreWebView2* sender,
            ICoreWebView2ContextMenuRequestedEventArgs* args)
        {
            auto showMenu = [this, args = 
            wil::com_ptr<ICoreWebView2ContextMenuRequestedEventArgs>(args)]
            {
                wil::com_ptr<ICoreWebView2ContextMenuItemCollection> items;
                CHECK_FAILURE(args->get_MenuItems(&items));
                CHECK_FAILURE(args->put_Handled(true));
                HMENU hPopupMenu = CHECK_POINTER(CreatePopupMenu());
                AddMenuItems(hPopupMenu, items);
                HWND hWnd;
                m_controller->get_ParentWindow(&hWnd);
                POINT locationInControlCoordinates;
                POINT locationInScreenCoordinates;
                CHECK_FAILURE(args->get_Location(&locationInControlCoordinates));
                // get_Location returns coordinates in relation to upper left Bounds
                // of the WebView2.Controller. Will need to convert to Screen 
                // coordinates to display the popup menu in the correct location.
                ConvertToScreenCoordinates(locationInControlCoordinates, 
                                           locationInScreenCoordinates);
                UINT32 selectedCommandId = TrackPopupMenu(
                                       hPopupMenu, 
                                       TPM_TOPALIGN | TPM_LEFTALIGN | TPM_RETURNCMD,
                                       locationInScreenCoordinates.x, 
                                       locationInScreenCoordinates.y, 
                                       0, 
                                       hWnd, 
                                       NULL);
                if (selectedCommandId != 0) {
                    CHECK_FAILURE(args->put_SelectedCommandId(selectedCommandId));
                }
            };
            wil::com_ptr<ICoreWebView2Deferral> deferral;
            CHECK_FAILURE(args->GetDeferral(&deferral));
            m_sampleWindow->RunAsync([deferral, showMenu]() {
                showMenu();
                CHECK_FAILURE(deferral->Complete());
            });
            return S_OK;
        }).Get(),
    &m_contextMenuRequestedToken);

void ContextMenu::AddMenuItems(
    HMENU hPopupMenu, wil::com_ptr<ICoreWebView2ContextMenuItemCollection> items)
    {
        wil::com_ptr<ICoreWebView2ContextMenuItem> current;
        UINT32 itemsCount;

        CHECK_FAILURE(items->get_Count(&itemsCount));
        for (UINT32 i = 0; i < itemsCount; i++)
        {
            CHECK_FAILURE(items->GetValueAtIndex(i, &current));
            COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND kind;
            CHECK_FAILURE(current->get_Kind(&kind));
            wil::unique_cotaskmem_string label;
            CHECK_FAILURE(current->get_Label(&label));
            std::wstring labelString = label.get();
            wil::unique_cotaskmem_string shortcut;
            CHECK_FAILURE(current->get_ShortcutKeyDescription(&shortcut));
            std::wstring shortcutString = shortcut.get();
            if (!shortcutString.empty())
            {
                labelString = labelString + L"\t" + shortcutString;
            }
            BOOL isEnabled;
            CHECK_FAILURE(current->get_IsEnabled(&isEnabled));
            BOOL isChecked;
            CHECK_FAILURE(current->get_IsChecked(&isChecked));
            INT32 commandId;
            CHECK_FAILURE(current->get_CommandId(&commandId));
            if (kind == COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR)
            {
                CHECK_BOOL(AppendMenu(hPopupMenu, MF_SEPARATOR, 0, nullptr));
            }
            else if (kind == COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SUBMENU)
            {
                HMENU newMenu = CHECK_POINTER(CreateMenu());
                wil::com_ptr<ICoreWebView2ContextMenuItemCollection> submenuItems;
                CHECK_FAILURE(current->get_Children(&submenuItems));
                BOOL isEnabled;
                CHECK_FAILURE(current->get_IsEnabled(&isEnabled));
                if (isEnabled)
                {
                    AddMenuItems(newMenu, submenuItems);
                    CHECK_BOOL(AppendMenu(hPopupMenu,
                                          MF_POPUP, 
                                          (UINT_PTR)newMenu, 
                                          labelString.c_str()));
                }
                else
                {
                    CHECK_BOOL(AppendMenu(hPopupMenu, 
                                          MF_POPUP | MF_GRAYED, 
                                          (UINT_PTR)newMenu, 
                                          labelString.c_str()));
                }
            }
            else if (
                kind == COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_CHECK_BOX ||
                kind == COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_RADIO)
            {
                if (isEnabled)
                {
                    if (isChecked)
                    {
                        CHECK_BOOL(AppendMenu(hPopupMenu, 
                                              MF_CHECKED | MF_STRING, 
                                              commandId, 
                                              labelString.c_str()));
                    }
                    else
                    {
                        CHECK_BOOL(AppendMenu(hPopupMenu, 
                                              MF_BYPOSITION | MF_STRING,
                                              commandId, 
                                              labelString.c_str()));
                    }
                }
                else
                {
                    if (isChecked)
                    {
                        CHECK_BOOL(AppendMenu(hPopupMenu, 
                                              MF_CHECKED | MF_GRAYED | MF_STRING, 
                                              commandId, 
                                              labelString.c_str()));
                    }
                    else
                    {
                        CHECK_BOOL(AppendMenu(hPopupMenu, 
                                              MF_GRAYED | MF_STRING, 
                                              commandId, 
                                              labelString.c_str()));
                    }
                }
            }
            else if (kind == COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND)
            {
                if (isEnabled)
                {
                    CHECK_BOOL(AppendMenu(hPopupMenu,
                                          MF_BYPOSITION | MF_STRING, 
                                          commandId, 
                                          labelString.c_str()));
                }
                else
                {
                    CHECK_BOOL(AppendMenu(hPopupMenu, 
                                          MF_GRAYED | MF_STRING, 
                                          commandId, 
                                          labelString.c_str()));
                }
            }
        }
    }

Добавление элементов меню в контекстное меню

Варианты действий:

• Добавьте элементы меню по умолчанию в пользовательское контекстное меню, как показано выше в разделе Добавление настраиваемого контекстного меню.

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

Добавление настраиваемых элементов меню в контекстное меню по умолчанию

Чтобы добавить настраиваемые элементы меню в контекстное меню по умолчанию, используйте следующие элементы API.

C#

• Класс CoreWebView2

  • Событие ContextMenuRequested

• Класс CoreWebView2ContextMenuItem

  • Событие CustomItemSelected

• Перечисление CoreWebView2ContextMenuItemKind

  • Command

• Класс CoreWebView2ContextMenuRequestedEventArgs

  • Свойство ContextMenuTarget
  • ContextMenuTarget.PageUri

• Класс CoreWebView2ContextMenuTarget

  • Свойство CoreWebView2ContextMenuTarget.PageUri

• Класс CoreWebView2Environment

  • Метод CreateContextMenuItem

C++

• ICoreWebView2_11

  • add_ContextMenuRequested

• ICoreWebView2ContextMenuItem

  • add_CustomItemSelected

• ICoreWebView2ContextMenuItemCollection

• ICoreWebView2ContextMenuRequestedEventArgs

  • get_MenuItems

• ICoreWebView2ContextMenuRequestedEventHandler

• ICoreWebView2CustomItemSelectedEventHandler

• ICoreWebView2Environment

  • CreateContextMenuItem

• перечисление COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND

  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND

Пример. Добавление настраиваемых элементов меню в контекстное меню по умолчанию

В следующем примере команда URI страницы отображения добавляется в контекстное меню WebView2.

C#

webView.CoreWebView2.ContextMenuRequested += delegate (object sender, 
                                    CoreWebView2ContextMenuRequestedEventArgs args)
{
    // add new item to end of collection
    CoreWebView2ContextMenuItem newItem = 
                        webView.CoreWebView2.Environment.CreateContextMenuItem(
        "Display Page Uri", null, CoreWebView2ContextMenuItemKind.Command);
        newItem.CustomItemSelected += delegate (object send, Object ex)
        {
            string pageUri = args.ContextMenuTarget.PageUri;
            System.Threading.SynchronizationContext.Current.Post((_) =>
            {
                MessageBox.Show(pageUri, "Page Uri", MessageBoxButton.OK);
            }, null);
        };
    menuList.Insert(menuList.Count, newItem);
};

C++

m_webView2_4 = m_webView.try_query<ICoreWebView2_4>();
webview2_4->add_ContextMenuRequested(
    Callback<ICoreWebView2ContextMenuRequestedEventHandler>(
        [this](
            ICoreWebView2* sender,
            ICoreWebView2ContextMenuRequestedEventArgs* args)
        {
            wil::com_ptr<ICoreWebView2ContextMenuItemCollection> items;
            CHECK_FAILURE(args->get_MenuItems(&items));
            UINT32 itemsCount;
            CHECK_FAILURE(items->get_Count(&itemsCount));
            // Adding a custom context menu item for the page that will display the page's URI.
            wil::com_ptr<ICoreWebView2Environment5> webviewEnvironment;
            CHECK_FAILURE(m_appWindow->GetWebViewEnvironment()->QueryInterface(
                IID_PPV_ARGS(&webviewEnvironment)));
            wil::com_ptr<ICoreWebView2ContextMenuItem> newMenuItem;
            CHECK_FAILURE(webviewEnvironment->CreateContextMenuItem(
                    L"Display page Uri", 
                    nullptr, 
                    COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND, &newMenuItem));
            newMenuItem->add_CustomItemSelected(
                        Callback<ICoreWebView2CustomItemSelectedEventHandler>(
                [this, info](
                    ICoreWebView2* sender,
                    IUnknown* args)
                    {
                        wil::unique_cotaskmem_string pageUri;
                        CHECK_FAILURE(info->get_PageUri(&pageUri));
                        std::wstring pageString = pageUri.get();
                        m_appWindow->RunAsync([this, pageString]()
                        {
                            MessageBox(
                                m_appWindow->GetMainWindow(), pageString.c_str(),
                                L"Display Page Uri", MB_OK);
                        });
                        return S_OK;
                    })
                    .Get(),
                nullptr);
            CHECK_FAILURE(items->InsertValueAtIndex(itemsCount, newMenuItem.get()));
            return S_OK;
        })
        .Get(),
    &m_contextMenuRequestedToken);

Удаление элементов меню из контекстного меню по умолчанию

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

C#

• Класс CoreWebView2ContextMenuItem

  • Свойство Name

• Событие ContextMenuRequested

• Класс CoreWebView2ContextMenuRequestedEventArgs

  • Свойство ContextMenuTarget
  • Свойство MenuItems

• Перечисление CoreWebView2ContextMenuTargetKind

  • Image

C++

• перечисление COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND

  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_IMAGE

• ICoreWebView2_4

• ICoreWebView2ContextMenuRequestedEventHandler

• ICoreWebView2ContextMenuRequestedEventArgs

  • get_MenuItems
  • get_ContextMenuTarget

• ICoreWebView2ContextMenuItemCollection

  • get_Count
  • GetValueAtIndex
  • InsertValueAtIndex
  • RemoveValueAtIndex

• ICoreWebView2ContextMenuTarget

  • get_kind

• ICoreWebView2ContextMenuItem

  • get_Name

Пример. Удаление элементов меню из контекстного меню по умолчанию

В следующем примере команда Сохранить изображение как удаляется из контекстного меню WebView2.

C#

webView.CoreWebView2.ContextMenuRequested += delegate (object sender, 
                                    CoreWebView2ContextMenuRequestedEventArgs args)
{
    IList<CoreWebView2ContextMenuItem> menuList = args.MenuItems;
    CoreWebView2ContextMenuTargetKind context = args.ContextMenuTarget.Kind;
    if (context == CoreWebView2ContextMenuTargetKind.Image)
    {
        for (int index = 0; index < menuList.Count; index++)
        {
            if (menuList[index].Name == "saveImageAs")
            {
                menuList.RemoveAt(index);
                break;
            }
        }
    }
};

C++

m_webView2_4 = m_webView.try_query<ICoreWebView2_4>();
webview2_4->add_ContextMenuRequested(
    Callback<ICoreWebView2ContextMenuRequestedEventHandler>(
        [this](
            ICoreWebView2* sender,
            ICoreWebView2ContextMenuRequestedEventArgs* args)
        {
            wil::com_ptr<ICoreWebView2ContextMenuItemCollection> items;
            CHECK_FAILURE(args->get_MenuItems(&items));
            wil::com_ptr<ICoreWebView2ContextMenuTarget> target;
            CHECK_FAILURE(args->get_ContextMenuTarget(&target));
            COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND context_kind;
            CHECK_FAILURE(target->get_Kind(&context_kind));
            UINT32 itemsCount;
            CHECK_FAILURE(items->get_Count(&itemsCount));
            // Removing the 'Save image as' context menu item for image context selections.
            if (context_kind == COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_IMAGE)
            {
                wil::com_ptr<ICoreWebView2ContextMenuItem> current;
                for(UINT32 i = 0; i < itemsCount; i++) 
                {
                    CHECK_FAILURE(items->GetValueAtIndex(i, &current));
                    wil::unique_cotaskmem_string name;
                    CHECK_FAILURE(current->get_Name(&name));
                    if (wcsmp(name.get(), L"saveImageAs") == 0)
                    {
                        CHECK_FAILURE(items->RemoveValueAtIndex(i));
                        break;
                    }
                }
            return S_OK;
        })
        .Get(),
    &m_contextMenuRequestedToken);

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

В этом разделе объясняется, как определить, когда пользователь запрашивает открытие контекстного меню. То же самое для пользовательских или контекстных меню по умолчанию.

Когда пользователь запрашивает открытие контекстного меню (например, щелкнув правой кнопкой мыши), приложение должно прослушивать ContextMenuRequested событие.

Когда приложение обнаруживает это событие, приложение должно выполнять некоторые из следующих действий:

• Добавление настраиваемых элементов меню в контекстное меню по умолчанию.
• Удалите настраиваемые элементы меню из контекстного меню по умолчанию.
• Откройте пользовательское контекстное меню.

Событие ContextMenuRequested указывает, что пользователь запросил открытие контекстного меню.

Элемент управления WebView2 вызывает это событие, чтобы указать, что пользователь запросил открытие контекстного меню в элементе управления WebView2, например путем щелчка правой кнопкой мыши.

Элемент управления WebView2 вызывает событие только в ContextMenuRequested том случае, если текущая веб-страница разрешает отображение контекстного меню, то есть если AreDefaultContextMenusEnabled свойство имеет значение true.

CoreWebView2ContextMenuRequestedEventArgs содержит следующие сведения:

• Упорядоченный ContextMenuItem список объектов для заполнения пользовательского контекстного меню. Упорядоченный список включает в себя следующее:

  • Внутреннее имя элемента меню.
  • Метка пользовательского интерфейса элемента меню, отображаемая для пользователя в пользовательском интерфейсе.
  • Тип пункта меню.
  • Сочетание клавиш Описание, если оно имеется, например ALT+C.
  • Любые другие свойства настраиваемого пункта меню.

• Координаты, в которых было запрошено контекстное меню, чтобы приложение смогла определить, какой элемент пользовательского интерфейса щелкнул пользователь правой кнопкой мыши. Координаты определяются по отношению к левому верхнему углу элемента управления WebView2.

• Объект выделения, который будет включать выбранный тип контекста и соответствующие данные параметров контекстного меню.

Когда пользователь выбирает пользовательский пункт меню в контекстном меню, элемент управления WebView2 вызывает CustomItemSelected событие.

Когда ведущее приложение указывает webView2, что пользователь выбрал пункт меню в контекстном меню, WebView2 затем выполняет выбранную команду.

C#

• Класс CoreWebView2

  • Событие ContextMenuRequested

• Класс CoreWebView2Settings

  • Свойство AreDefaultContextMenusEnabled

C++

• ICoreWebView2_11

  • add_ContextMenuRequested
  • remove_ContextMenuRequested

• ICoreWebView2Settings

  • get_AreDefaultContextMenusEnabled
  • put_AreDefaultContextMenusEnabled

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

Ваше ведущее приложение может обрабатывать выбранный пользователем пункт меню или возвращать его элементу управления WebView2 для обработки выбранного пользователем пункта меню.

Ведущее приложение должно прослушивать CustomItemSelected событие, которое возникает, когда пользователь выбирает пользовательский пункт меню в контекстном меню по умолчанию или в пользовательском контекстном меню.

Элемент управления WebView2 вызывает это событие, чтобы указать, что пользователь выбрал пользовательский пункт меню, добавленный приложением в контекстное меню.

Если пользователь выбирает пользовательский пункт меню, CustomMenuItemSelected событие возникает в выбранном объекте элемента контекстного меню в следующих случаях:

• Приложение добавляет настраиваемые элементы меню, но откладывает пользовательский интерфейс контекстного меню на платформу WebView2.

• Приложение добавляет настраиваемые элементы меню, отображает пользовательский интерфейс и задает SelectedCommandId для свойства идентификатор элемента пользовательского меню.

Сообщение о выбранном элементе меню команды в WebView2

Когда пользователь выбирает команду контекстного меню WebView2 (пункт меню по умолчанию, который находится в пользовательском контекстном меню), ведущее приложение может при необходимости сообщить об этом выборе в WebView2, чтобы WebView2 вызвал команду.

C#

• Перечисление CoreWebView2ContextMenuItemKind
  • CheckBox
  • Command
  • Radio
  • Separator
  • Submenu

C++

• перечисление COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_CHECK_BOX
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_RADIO
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SUBMENU

Настраиваемые элементы меню

Если ведущее приложение сообщает о пользовательском пункте меню в качестве выбранного CustomMenuItemSelected элемента меню, событие будет запущено для пользовательского пункта меню.

Отключение контекстных меню

Свойство AreDefaultContextMenusEnabled определяет, можно ли открыть любое контекстное меню. Если параметр WebView2 AreDefaultContextMenusEnabled имеет значение False, это отключает контекстные меню и ContextMenuRequested событие не будет возникать, например, когда пользователь щелкает правой кнопкой мыши.

C#

• Класс CoreWebView2Settings
  • Свойство AreDefaultContextMenusEnabled

C++

• ICoreWebView2Settings
  • get_AreDefaultContextMenusEnabled
  • put_AreDefaultContextMenusEnabled

Обзор справочника по API

C#

• Класс WebView2

  • Свойство ContextMenu

• Класс CoreWebView2

  • Событие ContextMenuRequested

• Класс CoreWebView2ContextMenuItem

  • Свойство Children
  • Свойство CommandId
  • Свойство Icon
  • Свойство IsChecked
  • Свойство IsEnabled
  • Свойство Kind
  • Свойство Label
  • Свойство Name
  • Свойство ShortcutKeyDescription
  • Событие CustomItemSelected

• Перечисление CoreWebView2ContextMenuItemKind

  • CheckBox
  • Command
  • Radio
  • Separator
  • Submenu

• Класс CoreWebView2ContextMenuRequestedEventArgs

  • Свойство ContextMenuTarget
  • Обработанное свойство
  • Свойство Location
  • Свойство MenuItems
  • Свойство SelectedCommandId
  • Метод GetDeferral

• Класс CoreWebView2ContextMenuTarget

  • Свойство CoreWebView2ContextMenuTarget.PageUri

• Перечисление CoreWebView2ContextMenuTargetKind

  • Audio
  • Image
  • Page
  • SelectedText
  • Video

• Класс CoreWebView2Deferral

  • Метод Complete

• Класс CoreWebView2Environment

  • Метод CreateContextMenuItem

• Класс CoreWebView2Settings

  • Свойство AreDefaultContextMenusEnabled

C++

• ICoreWebView2

• ICoreWebView2_4

• ICoreWebView2_11

  • add_ContextMenuRequested
  • remove_ContextMenuRequested

• ICoreWebView2ContextMenuItem

  • add_CustomItemSelected
  • get_Children
  • get_CommandId
  • get_Icon
  • get_IsChecked
  • get_IsEnabled
  • get_Kind
  • get_Label
  • get_Name
  • get_ShortcutKeyDescription
  • put_IsChecked
  • put_IsEnabled
  • remove_CustomItemSelected

• ICoreWebView2ContextMenuItemCollection

  • get_Count
  • GetValueAtIndex
  • InsertValueAtIndex
  • RemoveValueAtIndex

• ICoreWebView2ContextMenuRequestedEventArgs

  • get_ContextMenuTarget
  • get_Handled
  • get_Location
  • get_MenuItems
  • get_SelectedCommandId
  • GetDeferral
  • put_Handled
  • put_SelectedCommandId

• ICoreWebView2ContextMenuRequestedEventHandler

  • Вызова

• ICoreWebView2ContextMenuTarget

  • get_kind

• ICoreWebView2CustomItemSelectedEventHandler

• ICoreWebView2Deferral

  • Завершение

• ICoreWebView2Environment9

  • CreateContextMenuItem

• ICoreWebView2Settings

  • get_AreDefaultContextMenusEnabled
  • put_AreDefaultContextMenusEnabled

• перечисление COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND

  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_CHECK_BOX
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_RADIO
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR
  • COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SUBMENU

• перечисление COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND

  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_PAGE
  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_IMAGE
  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_SELECTED_TEXT
  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_AUDIO
  • COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_VIDEO

См. также

• Контекстные меню в обзоре функций и API WebView2.
• Репозиторий WebView2Samples