dotnet X11 设置窗口鼠标触摸命中穿透

本文记录如何在 X11 应用里面，使用 XShapeCombineRegion 方法配置一个 X11 窗口支持和 Win32 窗口一样的命中测试穿透功能，即对应 Win32 的 WS_EX_TRANSPARENT 的鼠标、触摸等的点击等动作的穿透功能，可以实现在窗口中挖空一块范围直接穿透到后面的窗口

在 X11 窗口中，想要实现让窗口不可命中，即所有的鼠标、触摸等的事件穿透到后面的窗口上，可以采用 libXext.so 提供的 XShapeCombineRegion 方法，也可以使用有争议的 libXfixes.so 提供的 XFixesSetWindowShapeRegion 方法

通过以上两个方法即可让 X11 窗口不响应鼠标或触摸的点击输入，让其输入到窗口后面的窗口。适合用来制作一个仅用来展示渲染的窗口，让这个窗口不参与到交互里面

使用比较有争议的 libXfixes.so 提供的 XFixesSetWindowShapeRegion 方法的示例代码如下

// 以下的 childWindowHandle 是一个 X11 窗口

var region = XFixesCreateRegion(display, 0, 0);
XFixesSetWindowShapeRegion(display, childWindowHandle, ShapeInput, 0, 0, region);

    [DllImport("libXfixes.so.3")]
    public static extern IntPtr XFixesCreateRegion(IntPtr display, IntPtr rectangles, int nrectangles);

    [DllImport("libXfixes.so.3")]
    public static extern void XFixesSetWindowShapeRegion(IntPtr display, IntPtr window, int shape_type, int x_offset,
        int y_offset, IntPtr region);

采用 libXext.so 提供的 XShapeCombineRegion 方法的示例代码如下

var region = XCreateRegion();
XShapeCombineRegion(display, childWindowHandle, ShapeInput, 0, 0, region, ShapeSet);

        [DllImport(libX11)]
        public static extern IntPtr XCreateRegion();

        [DllImport("libXext.so.6")]
        public static extern void XShapeCombineRegion(IntPtr display, IntPtr dest, int destKind, int xOff, int yOff, IntPtr region, int op);

我尝试创建两个窗口，其中一个窗口调用了 XShapeCombineRegion 方法，运行程序，将设置了的 XShapeCombineRegion 的窗口激活作为前台窗口，点击此窗口的内容，可以看到点击穿透到后面的窗口

以上两个方法都能实现功能，且通过阅读 X Server的代码，可以发现以上两个方法核心实现基本相同。为了可能的坑点在于 libXfixes.so 可能在某些系统上被砍掉。只是这个 libXfixes.so 也足够旧了，基本上系统都会带的

所有代码放在 github 和 gitee 上，可以使用如下命令行拉取代码

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 67cd9188399e7f45bfe83e1af9daf10236b3171c

以上使用的是 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码，将 gitee 源换成 github 源进行拉取代码

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 67cd9188399e7f45bfe83e1af9daf10236b3171c

获取代码之后，进入 DikalehebeekaJaqunicobo 文件夹，即可获取到源代码

以上代码经过我在 UOS 系统上测试通过，在 UOS 上的 KWin_X11 能够符合预期工作

如运行代码提示找不到 libXext.so 文件，错误内容如下

System.DllNotFoundException: Unable to load shared library 'libXext.so' or one of its dependencies. In order to help diagnose loading problems, consider using a tool like strace. If you're using glibc, consider setting the LD_DEBUG environment variable:
/home/uos/Downloads/lin/libXext.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/liblibXext.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/libXext.so.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/liblibXext.so.so: 无法打开共享对象文件: 没有那个文件或目录

   at CPF.Linux.XLib.XShapeCombineRegion(IntPtr display, IntPtr dest, Int32 destKind, Int32 xOff, Int32 yOff, IntPtr region, Int32 op)
   at UnoInk.X11Ink.X11InkWindow..ctor(X11Info x11Info, IntPtr mainWindowHandle)
   at UnoInk.X11Ink.X11InkProvider.Start(Window unoWindow)

可以尝试配置使用 libXext.so.6 版本，代码如下

        [DllImport("libXext.so.6")]
        public static extern void XShapeCombineRegion(IntPtr display, IntPtr dest, int destKind, int xOff, int yOff, IntPtr region, int op);

更新之后的代码放在 github 和 gitee 上，欢迎拉取代码阅读和构建

参考文档：

如何在屏幕上显示一局部透明、鼠标点击可穿过的窗口 - V2EX

2021-08-21窗口管理器杂谈 - 简书

更多 X11 开发请参阅 博客导航

关于在 Windows 系统下的 WPF 窗口点击穿透，请参阅 WPF 制作支持点击穿透的高性能的透明背景异形窗口