突出显示鼠标光标下的 NSWindow

Question

---

由于这是相当多的代码，如果有一个示例项目可以帮助您更好地理解当前问题，我制作了一个简单的示例项目，您可以在 GitHub 上找到它：https://github.com/dehlen/Stackoverflow

---

我想实现一些与 macOS 截图工具非常相似的功能。当鼠标悬停在窗口上时，该窗口应突出显示。但是，我只突出显示用户可见的窗口部分时遇到问题。

以下是该功能的屏幕截图：

然而，我当前的实现如下所示：

我当前的实现如下：

1.获取屏幕上所有可见窗口的列表

static func all() -> [Window] {
        let options = CGWindowListOption(arrayLiteral: .excludeDesktopElements, .optionOnScreenOnly)
        let windowsListInfo = CGWindowListCopyWindowInfo(options, CGMainDisplayID()) //current window
        let infoList = windowsListInfo as! [[String: Any]]
        return infoList
            .filter { $0["kCGWindowLayer"] as! Int == 0 }
            .map { Window(
                frame: CGRect(x: ($0["kCGWindowBounds"] as! [String: Any])["X"] as! CGFloat,
                       y: ($0["kCGWindowBounds"] as! [String: Any])["Y"] as! CGFloat,
                       width: ($0["kCGWindowBounds"] as! [String: Any])["Width"] as! CGFloat,
                       height: ($0["kCGWindowBounds"] as! [String: Any])["Height"] as! CGFloat),
                applicationName: $0["kCGWindowOwnerName"] as! String)}
    }

2。获取鼠标位置

private func registerMouseEvents() {
        NSEvent.addLocalMonitorForEvents(matching: [.mouseMoved]) {
            self.mouseLocation = NSEvent.mouseLocation
            return $0
        }
        NSEvent.addGlobalMonitorForEvents(matching: [.mouseMoved]) { _ in
            self.mouseLocation = NSEvent.mouseLocation
        }
    }

3.突出显示当前鼠标位置的窗口：

static func window(at point: CGPoint) -> Window? {
        // TODO: only if frontmost
        let list = all()
        return list.filter { $0.frame.contains(point) }.first
    }
var mouseLocation: NSPoint = NSEvent.mouseLocation {
        didSet {
            //TODO: don't highlight if its the same window
            if let window = WindowList.window(at: mouseLocation), !window.isCapture {
                highlight(window: window)
            } else {
                removeHighlight()
            }
        }
    }

 private func removeHighlight() {
        highlightWindowController?.close()
        highlightWindowController = nil
    }

    func highlight(window: Window) {
        removeHighlight()
        highlightWindowController = HighlightWindowController()
        highlightWindowController?.highlight(frame: window.frame, animate: false)
        highlightWindowController?.showWindow(nil)
    }

class HighlightWindowController: NSWindowController, NSWindowDelegate {
    // MARK: - Initializers
    init() {
        let bounds = NSRect(x: 0, y: 0, width: 100, height: 100)
        let window = NSWindow(contentRect: bounds, styleMask: .borderless, backing: .buffered, defer: true)
        window.isOpaque = false
        window.level = .screenSaver
        window.backgroundColor = NSColor.blue
        window.alphaValue = 0.2
        window.ignoresMouseEvents = true
        super.init(window: window)
        window.delegate = self
    }

    // MARK: - Public API
    func highlight(frame: CGRect, animate: Bool) {
        if animate {
            NSAnimationContext.current.duration = 0.1
        }
        let target = animate ? window?.animator() : window
        target?.setFrame(frame, display: false)
    }
}

如您所见，光标下的窗口被突出显示，但是突出显示的窗口被绘制在其他可能相交的窗口之上。

可能的解决方案 我可以遍历列表中的可用窗口，只找到不与其他窗口重叠的矩形，以便仅为这部分而不是整个窗口绘制高亮矩形。

我在问自己，对于这个问题，这是否会是一个更优雅、更高效的解决方案。也许我可以用绘制的 HighlightWindow 的窗口级别来解决这个问题？或者是否有任何来自 Apple 的 API，我可以利用它来获得所需的行为？

Answer 1

我弄乱了你的代码，@Ted 是正确的。 NSWindow.order(_:relativeTo) 正是您所需要的。

为什么 NSWindow.level 不起作用：

使用NSWindow.level 对您不起作用，因为普通窗口（如屏幕截图中的窗口）都有0 或.normal 的窗口级别。例如，如果您只是将窗口级别调整为“1”，您的突出显示视图将出现在所有其他窗口的上方。相反，如果您将其设置为“-1”，您的高亮视图将出现在所有普通窗口的下方，并在桌面上方。

使用 NSWindow.order(_: relativeTo) 引入的问题

没有警告就没有好的解决方案，对吧？为了使用此方法，您必须将窗口级别设置为0，以便它可以在其他窗口中分层。但是，这将导致在您的 WindowList.window(at: mouseLocation) 方法中选择突出显示窗口。当它被选中时，你的 if 语句会删除它，因为它认为它是主窗口。这将导致闪烁。 （对此的修复包含在下面的 TLDR 中）

此外，如果您尝试突出显示不级别为0 的窗口，您将遇到问题。要解决此类问题，您需要找到要突出显示的窗口的窗口级别并将突出显示窗口设置为该级别。 （我的代码没有包含解决这个问题的方法）

除了上述问题之外，您还需要考虑当用户将鼠标悬停在背景窗口上并在不移动鼠标的情况下单击它时会发生什么。将会发生的是背景窗口将变为前面。不移动突出显示窗口。一个可能的解决方法是更新点击事件的高亮窗口。

最后，我注意到您每次用户移动鼠标时都会创建一个新的HighlightWindowController + 窗口。如果您只是在鼠标移动时改变已经存在的HighlightWindowController 的框架（而不是创建一个），那么系统可能会更轻一些。要隐藏它，您可以调用 NSWindowController.close() 函数，甚至将框架设置为 {0,0,0,0}（不确定第二个想法）。

TLDR;给我们看一些代码

这就是我所做的。

1. 更改窗口结构以包含窗口编号：

struct Window {
    let frame: CGRect
    let applicationName: String
    let windowNumber: Int

    init(frame: CGRect, applicationName: String, refNumber: Int) {
        self.frame = frame.flippedScreenBounds
        self.applicationName = applicationName
        self.windowNumber = refNumber
    }

    var isCapture: Bool {
        return applicationName.caseInsensitiveCompare("Capture") == .orderedSame
    }
}

2.在您的窗口列表函数中，即static func all() -> [Window]，包括窗口编号：

refNumber: $0["kCGWindowNumber"] as! Int

3.在您的窗口突出显示功能中，在highlightWindowController?.showWindow(nil) 之后，相对于您要突出显示的窗口对窗口进行排序！

highlightWindowController!.window!.order(.above, relativeTo: window.windowNumber)

4.在您的高亮控制器中，确保将窗口级别设置回正常：

window.level = .normal

5. 窗口现在会闪烁，为防止这种情况，请更新您的视图控制器 if 语句：

    if let window = WindowList.window(at: mouseLocation) {
        if !window.isCapture {
            highlight(window: window)
        }
    } else {
        removeHighlight()
    }

祝你好运，玩得开心！

编辑：

我忘了说，我的 swift 版本是 4.2（还没有升级）所以语法可能会略有不同。

Answer 2

抱歉，我不习惯 Swift，但在我看来，解决这个问题的自然方法是使用 - orderWindow:relativeTo:。在 ObjC 中（在显示突出显示窗口后添加）：

[highlightWindow orderWindow:NSWindowAbove relativeTo:window];

并让窗口服务器处理隐藏隐藏部分的所有细节。当然，当用户在屏幕上移动内容时，将突出显示窗口保持在目标窗口的正上方会带来不同的麻烦，但是......