月份：2016年7月

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

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

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

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

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

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

去年，William Hua 和我开始致力于将 GTK+ 带入没有全局位置菜单窗口的美好未来。在提出一组可以做到这一点的补丁后，关于这样一个 API 实际看起来如何的讨论开始了。在 200-300 条评论之后，我们决定我们应该面对面讨论这个问题。

进入多伦多的 GTK2016！

在黑客马拉松中，我们有机会坐下来，在白板前讨论不同的用例、需要解决的问题、后端如何工作，最终我们提出了一个 API。

（图片来源：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 以查看有关将来如何放置菜单的所有详细信息。