标签：Wayland

相对窗口定位的未来

随着新兴的 显示 服务器 技术的发展，工具包有时需要调整其实现所提供功能的方式。一个需要调整的功能集是 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()，它接受一组参数来描述应用程序希望如何将其窗口放置在相对于某个父表面的位置。它需要

  • 一个 transient-for 窗口

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

  • 一个矩形锚点重力

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

  • 一个窗口锚点重力

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

  • 一个锚点提示

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

  • 一个矩形锚点偏移

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

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

但是，应用程序开发人员还不应直接使用此 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