NSTableView多列行拖拽重排：拖拽图像位置偏移问题求助

问题背景 #

我们开发的应用支持单/多列NSTableView行拖拽重排，原功能仅显示点击列的文本作为拖拽内容。优化后改用整行快照作为拖拽图像，但出现origin.x坐标异常问题：点击不同列时，拖拽图像偏左或偏右。初始尝试中图像甚至从窗口外“缩放”进入，临时设置X坐标为-500后有所改善但仍未解决。此外，session.enumerateDraggingItems返回的dragItem.draggingFrame.origin为负数，其初始属性对应点击的cell view，文档说明不够清晰，需要解决拖拽图像位置匹配鼠标点击位置的问题。

核心问题分析 #

1. 初始dragItem.draggingFrame基于点击的cell视图坐标系，而非整个tableView或窗口坐标系，因此会出现负数偏移
2. 未将鼠标点击位置与整行快照的锚点对齐，导致拖拽图像跟随鼠标时出现错位

解决步骤 #

• 计算鼠标在整行视图内的相对位置，以此作为拖拽图像的偏移基准
• 通过坐标系转换，将屏幕鼠标点转为rowView本地坐标
• 设置拖拽帧时，以鼠标相对位置的反值作为origin，确保拖拽图像的点击位置与鼠标完全对齐

修改后的完整代码 #

// 获取要拖拽的行索引并存储到粘贴板
func tableView(_ tableView: NSTableView, pasteboardWriterForRow row: Int) -> NSPasteboardWriting? {
    let pasteboardItem = NSPasteboardItem()
    pasteboardItem.setString(String(row), forType: .tableViewIndex)
    return pasteboardItem
}

// 处理拖拽会话开始逻辑
func tableView(_ tableView: NSTableView, draggingSession session: NSDraggingSession, willBeginAt screenPoint: NSPoint, forRowIndexes rowIndexes: IndexSet) {
    guard let draggedRow = rowIndexes.first else { return }
    guard let rowView = tableView.rowView(atRow: draggedRow, makeIfNecessary: true) else { return }
    let rowRectInTableView = tableView.rect(ofRow: draggedRow)
    
    // 将屏幕坐标转换为tableView本地坐标
    let mousePointInTableView = tableView.convert(screenPoint, from: nil)
    // 计算鼠标在rowView内的相对位置
    let mousePointInRowView = rowView.convert(mousePointInTableView, from: tableView)
    
    session.enumerateDraggingItems(options: [], for: tableView, classes: [NSPasteboardItem.self], searchOptions: [:]) { dragItem, _, _ in
        let rowSnapshot = rowView.snapshot()
        // 拖拽帧的size设为整行的实际尺寸
        let dragFrameSize = NSSize(width: rowRectInTableView.width, height: rowRectInTableView.height)
        // 关键：拖拽帧的origin偏移 = 鼠标在rowView内的坐标取反（让鼠标点对应快照的相同位置）
        let dragFrameOrigin = NSPoint(x: -mousePointInRowView.x, y: -mousePointInRowView.y)
        let dragFrame = NSRect(origin: dragFrameOrigin, size: dragFrameSize)
        
        dragItem.setDraggingFrame(dragFrame, contents: rowSnapshot)
    }
}

// 验证拖拽操作合法性
func tableView(_ tableView: NSTableView, validateDrop info: NSDraggingInfo, proposedRow row: Int, proposedDropOperation dropOperation: NSTableView.DropOperation) -> NSDragOperation {
    guard dropOperation == .above else { return [] }
    tableView.draggingDestinationFeedbackStyle = .regular
    return .move
}

// 处理拖拽完成后的行移动逻辑
func tableView(_ tableView: NSTableView, acceptDrop info: NSDraggingInfo, row: Int, dropOperation: NSTableView.DropOperation) -> Bool {
    guard let pbItems = info.draggingPasteboard.pasteboardItems,
          let pbItem = pbItems.first,
          let oldIndexString = pbItem.string(forType: .tableViewIndex),
          let oldIndex = Int(oldIndexString) else { return false }
    
    let oldIndexSet = IndexSet(integer: oldIndex)
    ItemManager.itemArray.move(with: oldIndexSet, to: row)
    
    tableView.beginUpdates()
    if oldIndex < row {
        tableView.moveRow(at: oldIndex, to: row - 1)
    } else {
        tableView.moveRow(at: oldIndex, to: row)
    }
    tableView.endUpdates()
    
    return true
}

关键修改说明 #

• 坐标转换链：从屏幕坐标→tableView本地坐标→rowView本地坐标，精准定位鼠标在整行内的点击位置
• 拖拽帧偏移计算：将鼠标在rowView内的坐标取反作为拖拽帧origin，确保拖拽时鼠标始终对准快照上的原点击位置，彻底解决偏移问题
• 尺寸匹配：直接使用tableView返回的整行rect尺寸，保证快照大小与实际行完全一致

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