标签: Mir

相对窗口定位的未来

随着新兴的显示服务器技术的发展，工具包有时需要调整它们实现其功能的方式。需要调整的一组功能是如何让 GTK+ 定位弹出窗口，例如菜单、弹出框和工具提示，以便它们被放置在显示器的可用工作区域内。

在过去，当 GTK+ 想要定位一个菜单时，它会首先查找菜单父窗口的全局位置。然后它会查找所有已连接显示器的工作区域。有了给定的工作区域、父窗口的全局位置以及相对于父窗口的预期菜单位置，GTK+ 会使用一个巧妙的算法来计算菜单的合理位置，以便它对用户可见。例如，如果“文件”菜单没有足够的空间在父菜单项下方弹出，那么 GTK+ 会将其重新定位到父菜单项的上方。

popup-flip

由于各种原因，这些新的显示服务器技术中，客户端已经移除了“全局窗口位置”的概念，这意味着我们不能再在 GTK+ 中使用我们巧妙的算法了。

但是，我们仍然希望我们的菜单、工具提示、弹出框等对期望与之交互的用户完全可见，那么我们如何在不知道窗口位置的情况下确保这一点呢？

为了在 GTK+ 中解决这个问题，我们必须解决许多问题。

  • 定位逻辑需要被移动到 GDK，同时仍然允许 GTK+ 影响菜单定位的行为，以防最初预期的位置最终在工作区域之外。
  • 不同的 GDK 后端可能会以不同的方式做事。
  • 某些类型的窗口需要知道它最终的位置，以便它们可以调整自身的绘制方式。
  • 有些窗口只是想尽可能多地占用空间（例如，选择项过多的菜单不应比屏幕高）。

去年，William Hua 和我开始致力于将 GTK+ 带入无全局位置菜单窗口的美好未来。在提出了一系列实现此功能的补丁后，关于这样一个 API 实际上会是什么样子开始了讨论。经过 200-300 条评论，我们决定我们可能应该当面讨论这个问题。

欢迎来到多伦多的 GTK2016！

在黑客节上，我们有机会坐在白板前，仔细研究不同的用例、需要解决的问题、后端如何工作，最终我们提出了一个 API。

william-draws-whiteboard（照片来源：Allison Lortie）

我们提出的 API 如下所示

从 GDK 方面，我们引入了一个新函数（到目前为止没有任何 API 稳定性保证；它目前仅供 GTK+ 使用）gdk_window_move_to_rect()，它接受一组参数来描述应用程序希望其窗口如何相对于某个父表面放置。它接受：

  • 一个临时窗口

要相对于其放置的父窗口。弹出窗口或菜单通常希望相对于父窗口上的一个矩形放置，例如，右键单击上下文菜单应该从单击时指针所在的像素向某个方向展开，或者文件菜单应该放置在父窗口上的文件菜单项矩形的下方或上方。

  • 一个矩形锚点重力

不同的弹出菜单可能希望在特定方向打开。例如，垂直菜单可能希望向右打开，而水平菜单可能希望向下打开。

  • 一个窗口锚点重力

不同的弹出菜单可能希望以不同的方式与父锚定矩形的锚定矩形对齐。例如，虽然组合框可能希望在特定方向展开，但它会希望覆盖它从中展开的矩形。

  • 一个锚点提示

不同的弹出菜单希望以不同的方式调整它们的位置；有些希望从父锚点矩形向不同方向展开，有些希望只是滑动到可见位置，有些希望调整大小，而有些则希望三者结合。

  • 一个矩形锚点偏移量

偏移量只是一个微调因子，用于弹出菜单相对于锚点偏移其位置的常见用例。

通过让 GTK+ 对其希望菜单如何定位进行声明性描述，我们允许 GDK 根据显示服务器系统的设计以不同的方式实现实际的定位。在 Mir 上，会创建一个 MirSurfaceSpec，而在 Wayland 上，会创建一个 xdg_positioner 对象。在 X11、Windows 和 Mac OS X 上，后端可以使用可用的全局位置以及显示器工作区域，并像以前一样计算出最佳位置。

然而，应用程序开发人员预计还不会直接使用此 API。通常需要的是创建一个菜单、一个弹出框、一个组合框，为此我们引入了一组参数和辅助函数，使其非常方便。该 API 由一些新属性组成：

  • GtkMenu:anchor-hints – 定位策略。
  • GtkMenu:rect-anchor-dx – 用于移动窗口的水平偏移量。
  • GtkMenu:rect-anchor-dy – 用于移动窗口的垂直偏移量。
  • GtkMenu:menu-type-hint – 窗口类型 - 这仍然是必需的，以便 X11 后端可以通知窗口管理器正在映射哪种类型的弹出窗口。

以及一些其他函数：

  • gtk_menu_popup_at_rect() – 给定设置的参数，相对于父窗口上的给定矩形弹出菜单。
  • gtk_menu_popup_at_widget() – 给定设置的参数，相对于父窗口上的给定部件弹出菜单。
  • gtk_menu_popup_at_pointer() – 给定设置的参数，相对于用户刚点击的位置弹出菜单。

有了这些函数，自定义部件的开发人员现在可以以可移植的方式定位弹出菜单。到目前为止，GTK+ 自己的弹出菜单已经移植到使用这些新函数。Mir 后端已经有一个基本的概念验证，并且正在进行 Wayland 实现。

前往 bug 查看未来如何放置菜单的所有详细信息。

gnome-sponsored-badge-shadow