Winforms下CefSharp的ChromiumWebBrowser干扰ContextMenuStrip如何解决

CefSharp 83.x版本的ChromiumWebBrowser默认会拦截控件范围内所有鼠标、键盘输入消息，内部自行处理上下文菜单逻辑，宿主WinForms的消息循环拿不到对应事件，直接拖到窗体上的ContextMenuStrip自然会丢失输入响应、失焦自动关闭等原生行为。 #

这个方案是Cef官方文档明确给出的菜单接管方式，不需要修改现有菜单业务逻辑，所有原生ContextMenuStrip行为都能保留：

1. 初始化Cef时先关闭默认的上下文菜单拦截

   var cefSettings = new CefSettings();
   // 禁用Cef内部的右键菜单逻辑
   cefSettings.CefCommandLineArgs.Add("disable-context-menu", "1");
   // 非离屏渲染场景不要开这个配置，开了会完全阻断宿主消息
   cefSettings.WindowlessRenderingEnabled = false;
   Cef.Initialize(cefSettings);
   

2. 实现自定义IContextMenuHandler，完全接管菜单弹出逻辑

   public class HostMenuHandler : IContextMenuHandler
   {
       public void OnBeforeContextMenu(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, IMenuModel model)
       {
           // 清空Cef自带的所有默认菜单项，阻止其内置菜单渲染
           model.Clear();
       }
   
       public bool OnContextMenuCommand(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, CefMenuCommand commandId, CefEventFlags eventFlags)
       {
           // 拦截所有Cef侧的菜单命令，不让浏览器处理
           return true;
       }
   
       public void OnContextMenuDismissed(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame)
       {
           // 留空即可，不需要额外处理
       }
   
       public bool RunContextMenu(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, IMenuModel model, IRunContextMenuCallback callback)
       {
           // 核心：返回true代表菜单完全由宿主接管，Cef不再拦截后续输入消息
           var browserControl = (ChromiumWebBrowser)chromiumWebBrowser;
           browserControl.BeginInvoke((Action)(() =>
           {
               // 替换为你自己的自定义ContextMenuStrip实例
               var myContextMenu = new CustomContextMenu();
               // 转换坐标为屏幕坐标后弹出菜单
               var popPosition = browserControl.PointToScreen(new Point(parameters.X, parameters.Y));
               myContextMenu.Show(popPosition);
               // 必须释放回调，否则Cef会一直阻塞在菜单等待状态，导致网页无响应
               callback.Dispose();
           }));
           return true;
       }
   }
   

3. 给浏览器实例绑定自定义Handler

   chromiumWebBrowser1.MenuHandler = new HostMenuHandler();
   

如果不想实现IContextMenuHandler，可以用全局消息过滤器补全菜单的失焦关闭逻辑：

• 直接把ChromiumWebBrowser的ContextMenu属性设为null，屏蔽默认右键菜单
• 给控件绑定MouseUp事件，判断右键点击时直接弹出自定义ContextMenuStrip
• 加全局消息过滤器处理失焦关闭：

  public class ContextMenuFixFilter : IMessageFilter
  {
      private const int WM_LBUTTONDOWN = 0x0201;
      private const int WM_RBUTTONDOWN = 0x0204;
      private const int WM_KEYDOWN = 0x0100;
  
      public bool PreFilterMessage(ref Message m)
      {
          if (CustomContextMenu.Visible && 
              (m.Msg == WM_LBUTTONDOWN || m.Msg == WM_RBUTTONDOWN || m.Msg == WM_KEYDOWN))
          {
              CustomContextMenu.Close();
          }
          return false;
      }
  }
  
  // 程序初始化时注册过滤器
  Application.AddMessageFilter(new ContextMenuFixFilter());
  

• 不要直接给ChromiumWebBrowser的ContextMenuStrip属性赋值，这个控件重写了WndProc，直接赋值的属性不会生效。
• 83.4.20版本的离屏渲染（OSR）模式存在消息回传bug，非必要不要开启，否则菜单输入会完全失效。
• 如果需要获取右键点选的网页元素信息（选中文本、图片地址、链接地址等），可以直接从RunContextMenu方法的parameters参数中读取，不需要额外注入JS。

内容的提问来源于stack exchange，提问作者Abet