使用WinAppDriver调用Maximize()最大化桌面窗口异常遮盖任务栏问题咨询

你调用的IWindow.Maximize()属于Appium/WinAppDriver提供的窗口操作接口，它的底层并没有模拟点击窗口右上角的最大化按钮，而是直接调用Windows原生API ShowWindow(hWnd, SW_MAXIMIZE) 实现窗口最大化，部分版本的驱动还会额外调用SetWindowPos直接强制设置窗口尺寸为物理屏幕大小。

手动点击最大化按钮不会触发该问题的原因是：手动点击时系统会主动计算当前屏幕的工作区边界（自动排除任务栏、系统侧边栏等固定区域），再设置窗口尺寸；而部分版本的驱动调用ShowWindow时，没有正确向系统请求工作区尺寸，直接将窗口拉伸到和物理屏幕等大，就会出现遮盖任务栏的问题，该问题属于驱动层面的实现Bug，仅在自动化调用时触发。

• 方案1：主动设置窗口尺寸为工作区大小
  直接获取系统主屏幕的工作区尺寸，手动调整窗口位置和大小，完全绕开驱动的Maximize实现，兼容性最高。
  代码示例：

  // 获取主屏幕工作区（自动排除任务栏等系统占地区域）
  var workingArea = System.Windows.Forms.Screen.PrimaryScreen.WorkingArea;
  var window = _driver.Manage().Window;
  // 先恢复窗口为普通状态，避免最大化/最小化状态无法调整尺寸
  window.Restore();
  // 设置窗口位置到工作区左上角
  window.Position = new System.Drawing.Point(workingArea.Left, workingArea.Top);
  // 设置窗口尺寸匹配工作区大小
  window.Size = new System.Drawing.Size(workingArea.Width, workingArea.Height);
  

• 方案2：发送系统原生最大化快捷键
  发送Win+向上箭头的系统全局快捷键，该操作由系统原生处理，效果和手动操作完全一致，不会出现遮盖任务栏的问题。
  代码示例：

  // 先激活目标窗口，避免快捷键发送到其他程序
  _driver.SwitchTo().Window(_driver.CurrentWindowHandle);
  // 发送Win+向上箭头触发系统最大化
  new Actions(_driver)
      .KeyDown(Keys.Meta)
      .SendKeys(Keys.ArrowUp)
      .KeyUp(Keys.Meta)
      .Perform();
  

• 方案3：发送窗口最大化原生消息
  直接向窗口句柄发送最大化系统消息，和手动点击最大化按钮触发的逻辑完全相同，效果最贴近手动操作，适合需要给研发复现问题的场景使用。
  代码示例：

  // 导入Win32 API
  [DllImport("user32.dll", CharSet = CharSet.Auto)]
  public static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
  private const uint WM_SYSCOMMAND = 0x0112;
  private const IntPtr SC_MAXIMIZE = (IntPtr)0xF030;
  
  // 调用逻辑
  IntPtr windowHandle = new IntPtr(long.Parse(_driver.CurrentWindowHandle, System.Globalization.NumberStyles.HexNumber));
  SendMessage(windowHandle, WM_SYSCOMMAND, SC_MAXIMIZE, IntPtr.Zero);
  

如果需要向研发团队定位问题，可以使用Spy++工具抓取调用Maximize()前后的窗口样式参数，确认驱动是否修改了窗口的置顶属性、边框样式，也可以尝试回退WinAppDriver到v1.2.0版本，该版本的Maximize实现不存在上述Bug。

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