class NSWindowController : NSResponder
用于管理window的控制器,通常是存储在nib文件中的window
管理窗口需要:
1)加载/显示窗口
2)适时关闭窗口
3)定制窗口标题
4)将窗口的frame存储在默认的数据库中
5)级联app中的其他关联的document window
window controller 可以自己管理window,或者基于AppKit中document框架(包含了NSDocument,NSDocumentController对象)来管理window.在这个架构中, 一个window controller是被NSDocuemnt子类的实例document来创建和管理,并依次保留对document对象的引用。
window controller和nib文件之间的关系非常重要。虽然widnow controller 可以通过编程方式来创建一个window, 但是通常它通过nib文件来创建window。nib文件可以包含一些其他顶级的对象, 包含其他的windows,但是这个window controller的职责是这个主窗口。window controller一般是nib文件的拥有者,即使它是基于document app的一部分。无论谁是nib文件的所有者,window controller负责释放它加载的nib文件中所有顶级对象。
对于一些简单的,比如只有一个nib文件,该文件包含一个window,AppKit已经为我们创建了一个NSWindowControllerl,我们可以直接使用。如果默认的window controller不能满足我们的需求,我们可以子类化NSWindowController。对于有多个window和panel的文档,我们必须分别每个widnow和panel创建NSWindowController的实例。比如CAD应用具有不同的窗口渲染对象的top, side,和front视图。你在NSDocument子类中所做的决定了使用默认的NSWindowcontroller还是单独创建和配置的NSWindowController对象。
子类化 NSWindowController
当我们想要增加一些默认的行为时,我们可以创建一个NSWindowController的子类,比如在window加载之前给window一个定制化的标题或者或者设置一些任务。在类的初始化方法中,一定要在调用super. initWithWindowNibName或者super.init(window:)中的一个。我们选择的初始化方法取决于window对象是通过nib文件还是编程方式创建。
当然,我们还可以实现NSWindowController子类来避免要求客户端代码获取nib文件名并且当初始化window controller的时候传递到init(windowNibName:) 或者 init(windowNibName: owner:)
。最好的方法是重写windowNibName然后返回nib文件的名称和通过将nil传递给init(window:)来实例化window controller。使用指定的init(window:)初始化简化了swift初始化要求。
通常,你只需要重写以下方法即可:
windowWillLoad(): 在nib文件加载前覆盖以执行任务。
windowDidLoad() : 在nib文件加载后覆盖以执行任务。
windowTitle(forDucomentDisplayName:) :用以定制window标题。
我们还可以重写loadWindow()来获取不同的nib查找 或者nib加载行为,虽然我们通常不需要这么做。
初始化 WindowController
init(window: NSWindow?)
通过指定的widnow实例化一个WindowController.
init(windowNibName: NSNib.name)
通过一个nib文件初始化WindowController
init(widnowNibName: NSNib.name, owner:Any)
通过nib文件和一个指定的nib文件的owner来初始化WindowController
init(windowNibPath: String, owner: Any)
通过nib文件的绝对路径和owner来实例化WindowController
加载和显示Window
func loadWindow()
从nib文件中加载receiver's widnow
func showWindow(Any?)
显示与receiver关联的window
var isWindowLoaded: Bool
包含reciever‘s widnow的nib文件是否已被加载。
var window: NSWincow?
reciever 拥有的window
访问该属性时如果nib文件还未被加载时,会加载该nib文件。
如果widnow已经被加载 windowWillLoad(),loadWindow()和windowDidLoad()方法会被顺序调用。
如果windowController有一个document,
这个document的windowControllerWillLoadNib(_:)和windowControllerDidLoadNib(_:)也被调用。
我们也经常重写这些方法,在这些事情前后来影响nib的加载或者做一些其他事情。
设置此属性会释放窗口控制器的旧窗口以及nib文件中的任何关联的顶级对象,并建立新窗口的所有权。
通常我们不应该使用此属性来设置窗口。
而是为新窗口创建一个新的窗口控制器,然后释放旧的窗口控制器。
func windowDidLoad()
func windowWillLoad()
在window 加载前/后调用
关闭Window
func close()
关闭加载完成的widnow
var sholdCloseDocument: Bool
true:当它管理的window关闭时关闭与document的关联
false:当他管理的window关闭时,不关闭与document的关联
网友评论