MacOS Storyboard应用中SwiftUI托管窗口的坐标定位异常求助

问题描述 #

在基于Storyboard的旧版macOS应用中，通过SwiftUI创建新窗口时出现坐标系统冲突：

• 调用window.center()时，窗口左上角水平居中，垂直方向卡在菜单栏下方，并非窗口整体居中
• 调用window.setFrameTopLeftPoint(.init(x: 0, y: 0))时，窗口被定位到屏幕左下角，坐标明显反转

问题代码 #

窗口创建逻辑 #

@IBAction func onButtonClicked(_ sender: Any) {
    let window = NSWindow(
        contentRect: .init(origin: .zero, size: .init(width: 400, height: 400)),
        styleMask: [.titled, .closable],
        backing: .buffered,
        defer: false
    )

    window.title = "Child SwiftUI Window"
    // window.center()
    window.setFrameTopLeftPoint(.init(x: 100, y: 100))

    let windowController = NSWindowController(window: window)
    windowController.contentViewController = ChildHostingController()!
    windowController.showWindow(nil)
}

SwiftUI视图与托管控制器 #

class ChildHostingController: NSHostingController<SwiftUITestView> {
    required init?(coder: NSCoder) {
        super.init(coder: coder, rootView: SwiftUITestView())
    }
    required init?() {
        super.init(rootView: SwiftUITestView())
    }
}

struct SwiftUITestView: View {
    var body: some View {
        VStack { 
            Spacer()
            Text("This is a child window from SwiftUI")
            Spacer()
        }
        .padding(20)
        .frame(width: 400, height: 400)
    }
}

解决方法 #

1. 修正窗口初始化参数 #

问题核心之一是defer: false会让窗口立即应用布局，而后续设置SwiftUI内容控制器会修改窗口尺寸，导致坐标计算错误。同时需要绑定屏幕，避免跨屏幕坐标偏差：

@IBAction func onButtonClicked(_ sender: Any) {
    let mainScreen = NSScreen.main!
    let windowSize = CGSize(width: 400, height: 400)
    
    // 转换为AppKit的左下角原点坐标
    let origin = CGPoint(x: 100, y: mainScreen.frame.maxY - 100 - windowSize.height)

    let window = NSWindow(
        contentRect: CGRect(origin: origin, size: windowSize),
        styleMask: [.titled, .closable],
        backing: .buffered,
        defer: true, // 延迟布局，等待内容控制器设置完成
        screen: mainScreen // 指定所属屏幕
    )

    window.title = "Child SwiftUI Window"
    let windowController = NSWindowController(window: window)
    windowController.contentViewController = ChildHostingController()!
    
    // 若需要居中，在此处调用（确保内容尺寸已确定）
    // window.center()
    
    windowController.showWindow(nil)
}

2. 移除SwiftUI视图的强制尺寸约束 #

SwiftUI视图中的.frame(width: 400, height: 400)会强制覆盖NSWindow的初始尺寸设置，导致坐标计算失效。移除该约束，让窗口尺寸由NSWindow初始化时的contentRect决定：

struct SwiftUITestView: View {
    var body: some View {
        VStack { 
            Spacer()
            Text("This is a child window from SwiftUI")
            Spacer()
        }
        .padding(20)
        // 移除固定frame，窗口尺寸将遵循NSWindow的设置
    }
}

3. 坐标转换工具（可选） #

如果需要频繁使用“左上角为原点”的习惯坐标，可以封装转换方法：

/// 将左上角原点坐标转换为AppKit的左下角原点坐标
func convertToAppKitOrigin(topLeftPoint: CGPoint, windowSize: CGSize) -> CGPoint {
    guard let screen = NSScreen.main else { return topLeftPoint }
    return CGPoint(
        x: topLeftPoint.x,
        y: screen.frame.maxY - topLeftPoint.y - windowSize.height
    )
}

使用示例：

let desiredTopLeft = CGPoint(x: 100, y: 100) // 左上角为原点的目标位置
let appKitOrigin = convertToAppKitOrigin(topLeftPoint: desiredTopLeft, windowSize: windowSize)
window.setFrameTopLeftPoint(appKitOrigin)

内容的提问来源于stack exchange，提问作者Soid