INPopoverController 技术文档

1. 安装指南

INPopoverController 的安装非常简单，您可以直接从 GitHub 上克隆项目代码，然后将其集成到您的开发环境中。

git clone https://github.com/indragiek/INPopoverController.git

将克隆下来的项目拖入您的 Xcode 工程中，确保选择正确的目标。然后，您可以在项目中导入 INPopoverController 的头文件，开始使用。

2. 项目使用说明

INPopoverController 是一个开源的 OS X 弹出窗口实现，适用于不支持 NSPopover 类的旧版本 OS X 系统。该类提供了以下特性：

• 可自定义颜色、边框颜色、边框宽度、箭头大小和圆角。
• 自动计算最佳箭头方向，根据屏幕空间和弹出窗口位置确定。
• 支持从常规 NSViewController（可以从 NIB 加载）显示内容。
• 弹出窗口显示/消失时的动画效果，以及在内容大小改变时的动画效果。
• 弹出窗口可以锚定到一个视图上。
• 可自定义弹出窗口行为（如失去键盘状态时关闭，应用程序变为非活动状态时关闭）。

使用方法如下：

• 通过 color、borderColor 和 borderWidth 属性自定义弹出窗口的外观。
• 在 INPopoverControllerDefines.h 文件中修改预定义常量，以进一步自定义外观。
• 使用 closesWhenPopoverResignsKey 和 closesWhenApplicationBecomesInactive 属性控制弹出窗口的行为。

如果需要完全自定义弹出窗口的绘制，可以编辑 INPopoverWindowFrame.m 文件，在其中添加自己的绘制代码，确保在绘制时考虑 arrowDirection 属性。

3. 项目API使用文档

以下为 INPopoverController 的主要 API：

• color: 设置弹出窗口颜色。
• borderColor: 设置边框颜色。
• borderWidth: 设置边框宽度。
• arrowDirection: 获取或设置箭头方向。
• closesWhenPopoverResignsKey: 设置是否在失去键盘焦点时关闭弹出窗口。
• closesWhenApplicationBecomesInactive: 设置是否在应用程序变为非活动状态时关闭弹出窗口。

更多 API 请参考项目头文件中的注释说明。

4. 项目安装方式

如前所述，您可以通过从 GitHub 克隆项目代码，然后将其集成到您的 Xcode 工程中。此外，您还可以使用 CocoaPods 或 Carthage 等依赖管理工具进行安装。

使用 CocoaPods：

pod 'INPopoverController'

使用 Carthage：

github "indragiek/INPopoverController"

安装完成后，您可以在项目中导入 INPopoverController 的头文件，开始使用。