Personnaliser les menus contextuels dans WebView2

Article
03/29/2023

Le contrôle WebView2 fournit un menu contextuel par défaut, et vous pouvez créer votre propre menu contextuel lors de l’utilisation d’un contrôle WebView2. Utilisez l’API ContextMenuRequested pour personnaliser les menus contextuels (menus contextuels) d’une application WebView2. Par exemple, vous pouvez effectuer l’une des opérations suivantes :

Ajoutez un menu contextuel personnalisé.

Au lieu d’utiliser le menu contextuel par défaut, votre application hôte peut dessiner son propre menu contextuel en utilisant les informations envoyées à partir du menu contextuel WebView2. Votre application gère l’événement ContextMenuRequested . Vous pouvez utiliser les données fournies dans les arguments Événement de ContextMenuRequested pour afficher un menu contextuel personnalisé avec les entrées de votre choix. Dans ce cas, vous gérez l’événement et demandez un report.

Vous pouvez ajouter des éléments de menu par défaut et/ou des éléments de menu personnalisés à un menu contextuel personnalisé.
Ajoutez des éléments de menu par défaut à un menu contextuel personnalisé.
Ajoutez des éléments de menu personnalisés à un menu contextuel par défaut.
Supprimez les éléments de menu par défaut ou personnalisés du menu contextuel par défaut.
Désactivez les menus contextuels.

Terminologie:

Terme	Définition
Menu	Un terme large. Inclut la case à cocher, la commande, la case d’option, le séparateur et le sous-menu.
commander	Un terme étroit. Un des cinq types d’éléments de menu.
menu contextuel	Soit un menu contextuel par défaut (menu contextuel) appartenant au contrôle WebView2, soit un menu contextuel personnalisé (menu contextuel) appartenant à votre application hôte.

Au lieu d’utiliser le menu contextuel par défaut, votre application hôte peut dessiner son propre menu contextuel en utilisant les informations envoyées à partir du menu contextuel WebView2. Votre application gère l’événement ContextMenuRequested . Vous pouvez utiliser les données fournies dans les arguments Événement de ContextMenuRequested pour afficher un menu contextuel personnalisé avec les entrées de votre choix. Dans ce cas, vous gérez l’événement et demandez un report.

Lorsque l’utilisateur sélectionne une commande dans votre menu contextuel personnalisé, votre application doit indiquer au contrôle WebView2 la commande sélectionnée par l’utilisateur à l’aide de la SelectedCommandId propriété .

Vous pouvez ajouter des éléments de menu par défaut et/ou des éléments de menu personnalisés à un menu contextuel personnalisé.

Pour afficher un menu contextuel personnalisé qui contient les éléments de menu souhaités, utilisez les données fournies dans l’événement CoreWebView2ContextMenuRequestedEventArgsCoreWebView2ContextMenuRequested. Dans ce cas, vous spécifiez Handled la valeur trueet demandez un report.

Sur un CoreWebView2.ContextMenuRequested événement, ajoutez un écouteur d’événements qui a un CoreWebView2ContextMenuRequestedEventArgs.

La MenuItems propriété de CoreWebView2ContextMenuRequestedEventArgs fournit l’arborescence des éléments de menu contextuel de WebView2 pour le contexte avec clic droit. Pour inclure des éléments de menu contextuel WebView2 dans le menu contextuel de votre application, effectuez une itération dans le IList<CoreWebView2ContextMenuItem>, en ajoutant un CoreWebView2ContextMenuItem pour chaque élément de menu. Testez le .Kind de chaque élément de menu, par Command exemple ou Separator.

CoreWebView2, classe
- Événement ContextMenuRequested
CoreWebView2ContextMenuItem, classe
CoreWebView2ContextMenuRequestedEventArgs, classe
CoreWebView2ContextMenuItemKind Enum
- CoreWebView2ContextMenuItemKind.Command
- CoreWebView2ContextMenuItemKind.Separator
CoreWebView2ContextMenuTargetKind Enum
CoreWebView2Deferral, classe
- Complete, méthode
CoreWebView2ContextMenuItemKind Enum
- CheckBox
- Radio
- Separator
- Submenu

Pour afficher un menu contextuel personnalisé qui contient les éléments de menu souhaités, utilisez les données fournies dans ICoreWebView2ContextMenuRequestedEventArgs. Dans ce cas, vous spécifiez Handled la valeur trueet demandez un report.

Sur un ContextMenuRequested événement, ajoutez un écouteur d’événements qui a un ICoreWebView2ContextMenuRequestedEventArgs.

Effectuez une itération au sein d’une liste d’éléments ICoreWebView2ContextMenuItem , en ajoutant un ICoreWebView2ContextMenuItem pour chaque élément de menu. Testez le COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND de chaque élément de menu, par COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR exemple ou COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_COMMAND.

ICoreWebView2_11
- add_ContextMenuRequested
- remove_ContextMenuRequested
ICoreWebView2ContextMenuItem
ICoreWebView2ContextMenuItemCollection
- get_Count
- GetValueAtIndex
ICoreWebView2ContextMenuRequestedEventArgs
ICoreWebView2ContextMenuRequestedEventHandler
ICoreWebView2Deferral
énumération COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND
- COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SEPARATOR
- COREWEBVIEW2_CONTEXT_MENU_ITEM_KIND_SUBMENU
énumération COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND

L’exemple suivant présente le menu contextuel WebView2 au format de menu contextuel Win32/WPF.

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);
    }
}

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()));
                }
            }
        }
    }

Vous pouvez :

Ajoutez des éléments de menu par défaut à un menu contextuel personnalisé, comme indiqué ci-dessus dans « Ajout d’un menu contextuel personnalisé ».
Ajoutez des éléments de menu personnalisés à un menu contextuel par défaut, comme indiqué ci-dessous dans « Ajout d’éléments de menu personnalisés à un menu contextuel par défaut ».

Pour ajouter des éléments de menu personnalisés au menu contextuel par défaut, utilisez les éléments d’API suivants.

CoreWebView2, classe
- Événement ContextMenuRequested
CoreWebView2ContextMenuItem, classe
- Événement CustomItemSelected
CoreWebView2ContextMenuItemKind Enum
- Command
CoreWebView2ContextMenuRequestedEventArgs, classe
- ContextMenuTarget, propriété
- ContextMenuTarget.PageUri
CoreWebView2ContextMenuTarget, classe
- CoreWebView2ContextMenuTarget.PageUri, propriété
CoreWebView2Environment, classe
- CreateContextMenuItem, méthode

L’exemple suivant ajoute une commande d’URI de page d’affichage au menu contextuel WebView2.

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);
};

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);

Vous pouvez supprimer les éléments de menu par défaut ou personnalisés du menu contextuel par défaut.

énumération COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND
- COREWEBVIEW2_CONTEXT_MENU_TARGET_KIND_IMAGE
ICoreWebView2_4
ICoreWebView2ContextMenuRequestedEventHandler
ICoreWebView2ContextMenuRequestedEventArgs
- get_MenuItems
- get_ContextMenuTarget
ICoreWebView2ContextMenuItemCollection
ICoreWebView2ContextMenuTarget
- get_kind
ICoreWebView2ContextMenuItem
- get_Name

L’exemple suivant supprime la commande Enregistrer l’image sous du menu contextuel WebView2.

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;
            }
        }
    }
};

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);

Cette section explique comment détecter quand l’utilisateur demande l’ouverture d’un menu contextuel. Il en va de même pour les menus contextuels personnalisés ou par défaut.

Lorsqu’un utilisateur demande l’ouverture d’un menu contextuel (par exemple, en cliquant avec le bouton droit), votre application doit écouter l’événement ContextMenuRequested .

Lorsque votre application détecte cet événement, elle doit effectuer une combinaison des opérations suivantes :

Ajoutez des éléments de menu personnalisés au menu contextuel par défaut.
Supprimez les éléments de menu personnalisés du menu contextuel par défaut.
Ouvrez un menu contextuel personnalisé.

L’événement ContextMenuRequested indique que l’utilisateur a demandé l’ouverture d’un menu contextuel.

Le contrôle WebView2 déclenche cet événement pour indiquer que l’utilisateur a demandé l’ouverture d’un menu contextuel dans le contrôle WebView2, par exemple en cliquant avec le bouton droit.

Le contrôle WebView2 déclenche l’événement ContextMenuRequested uniquement si la page web active autorise l’affichage du menu contextuel ; autrement dit, si la AreDefaultContextMenusEnabled propriété est true.

CoreWebView2ContextMenuRequestedEventArgs contient les informations suivantes :

Liste ordonnée d’objets ContextMenuItem pour remplir le menu contextuel personnalisé. La liste triée comprend les éléments suivants :
- Nom interne de l’élément de menu.
- Étiquette de l’interface utilisateur de l’élément de menu, affichée à l’utilisateur dans l’interface utilisateur.
- Type d’élément de menu.
- Raccourci clavier Description, le cas échéant, par exemple Alt+C.
- Toutes les autres propriétés de l’élément de menu personnalisé.
Coordonnées où le menu contextuel a été demandé, afin que votre application puisse détecter l’élément d’interface utilisateur sur lequel l’utilisateur a cliqué avec le bouton droit. Les coordonnées sont définies par rapport au coin supérieur gauche du contrôle WebView2.
Objet de sélection qui inclut le type de contexte sélectionné et les données de paramètre de menu contextuel appropriées.

Lorsque l’utilisateur sélectionne un élément de menu personnalisé dans un menu contextuel, le contrôle WebView2 déclenche un CustomItemSelected événement.

Lorsque votre application hôte indique à WebView2 qu’un utilisateur a sélectionné un élément de menu dans un menu contextuel, WebView2 exécute ensuite la commande sélectionnée.

Votre application hôte peut gérer l’élément de menu sélectionné par l’utilisateur, ou votre application peut renvoyer l’élément de menu au contrôle WebView2 pour gérer l’élément de menu sélectionné par l’utilisateur.

Votre application hôte doit écouter l’événement CustomItemSelected , qui est déclenché lorsque l’utilisateur sélectionne un élément de menu personnalisé dans un menu contextuel par défaut ou personnalisé.

Le contrôle WebView2 déclenche cet événement pour indiquer que l’utilisateur a sélectionné un élément de menu personnalisé que votre application a ajouté à un menu contextuel.

Si l’utilisateur sélectionne un élément de menu personnalisé, l’événement CustomMenuItemSelected est déclenché sur l’objet élément de menu contextuel sélectionné, dans les cas suivants :

L’application ajoute des éléments de menu personnalisés, mais reporte l’interface utilisateur du menu contextuel à la plateforme WebView2.
L’application ajoute des éléments de menu personnalisés, affiche une interface utilisateur personnalisée et définit la SelectedCommandId propriété sur l’ID de l’élément de menu personnalisé.

Lorsque l’utilisateur sélectionne une commande de menu contextuel WebView2 (élément de menu par défaut qui se trouve dans un menu contextuel personnalisé), l’application hôte peut éventuellement signaler cette sélection à WebView2 afin que WebView2 appelle la commande.

CoreWebView2ContextMenuItemKind Enum
- CheckBox
- Command
- Radio
- Separator
- Submenu

Si votre application hôte signale un élément de menu personnalisé comme élément de menu sélectionné, l’événement CustomMenuItemSelected est déclenché pour l’élément de menu personnalisé.

Désactivation des menus contextuels

La AreDefaultContextMenusEnabled propriété détermine si un menu contextuel peut être ouvert. Si le paramètre WebView2 AreDefaultContextMenusEnabled est défini sur False, cela désactive les menus contextuels et que l’événement ContextMenuRequested ne se déclenche pas, par exemple lorsque l’utilisateur clique avec le bouton droit.

CoreWebView2Settings, classe
- AreDefaultContextMenusEnabled, propriété

Vue d’ensemble des informations de référence sur les API

Classe WebView2
- ContextMenu, propriété
CoreWebView2, classe
- Événement ContextMenuRequested
CoreWebView2ContextMenuItem, classe
CoreWebView2ContextMenuItemKind Enum
- CheckBox
- Command
- Radio
- Separator
- Submenu
CoreWebView2ContextMenuRequestedEventArgs, classe
CoreWebView2ContextMenuTarget, classe
- CoreWebView2ContextMenuTarget.PageUri, propriété
CoreWebView2ContextMenuTargetKind Enum
- Audio
- Image
- Page
- SelectedText
- Video
CoreWebView2Deferral, classe
- Complete, méthode
CoreWebView2Environment, classe
- CreateContextMenuItem, méthode
CoreWebView2Settings, classe
- AreDefaultContextMenusEnabled, propriété

ICoreWebView2
ICoreWebView2_4
ICoreWebView2_11
- add_ContextMenuRequested
- remove_ContextMenuRequested
ICoreWebView2ContextMenuItem
ICoreWebView2ContextMenuItemCollection
ICoreWebView2ContextMenuRequestedEventArgs
ICoreWebView2ContextMenuRequestedEventHandler
- Invoquer
ICoreWebView2ContextMenuTarget
- get_kind
ICoreWebView2CustomItemSelectedEventHandler
ICoreWebView2Deferral
- Complete
ICoreWebView2Environment9
- CreateContextMenuItem
ICoreWebView2Settings
- get_AreDefaultContextMenusEnabled
- put_AreDefaultContextMenusEnabled
énumération 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
énumération 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

Voir aussi

Menus contextuels dans Vue d’ensemble des fonctionnalités et API WebView2.
Référentiel WebView2Samples

Partager via

Personnaliser les menus contextuels dans WebView2

Ajout d’un menu contextuel personnalisé

Exemple : ajout d’un menu contextuel personnalisé

Ajout d’éléments de menu à un menu contextuel

Ajout d’éléments de menu personnalisés à un menu contextuel par défaut

Exemple : ajout d’éléments de menu personnalisés à un menu contextuel par défaut

Suppression d’éléments de menu d’un menu contextuel par défaut

Exemple : suppression d’éléments de menu d’un menu contextuel par défaut

Détection du moment où l’utilisateur demande un menu contextuel

Détection du moment où l’utilisateur sélectionne un élément de menu personnalisé

Signalement d’un élément de menu de commande sélectionné à WebView2

Éléments de menu personnalisés

Désactivation des menus contextuels

Vue d’ensemble des informations de référence sur les API

Voir aussi

Commentaires

Ressources supplémentaires