DDExpandableButton 技术文档

1. 安装指南

环境要求

• iOS 5.0 及以上版本
• 支持 ARC（自动引用计数）和非 ARC 项目

安装步骤

1. 下载 DDExpandableButton 类文件。
2. 将 DDExpandableButton.h 和 DDExpandableButton.m 文件添加到您的 Xcode 项目中。
3. 如果您的项目使用 ARC，请确保在 DDExpandableButton.m 文件中添加 -fno-objc-arc 编译标志，或者将项目设置为非 ARC 模式。

2. 项目的使用说明

DDExpandableButton 是一个可扩展的 UIButton，类似于 iOS 相机应用中的闪光灯按钮。它允许用户在点击按钮时展开多个选项，并选择其中一个。

主要功能

• 可扩展按钮：点击按钮时展开多个选项。
• 动画支持：按钮展开和收缩时可以启用动画效果。
• 超时收缩：按钮在展开后可以设置超时时间，自动收缩。
• 自定义样式：支持自定义按钮的边框、文本颜色、字体等。

3. 项目 API 使用文档

属性

• expanded：当前按钮的状态（展开或收缩）。
• useAnimation：是否在按钮状态转换时使用动画。
• toggleMode：是否将按钮用作切换模式（如“HDR 开/关”按钮）。
• timeout：按钮展开后自动收缩的超时时间，设置为 0 则禁用超时。
• horizontalPadding：项目之间的水平间距。
• verticalPadding：项目之间的垂直间距。
• borderWidth：按钮边框的宽度。
• innerBorderWidth：项目之间内边框的宽度。
• selectedItem：当前选中的项目编号。
• borderColor：按钮和内边框的颜色。
• textColor：文本标签的颜色。
• labelFont：文本标签的字体。
• unSelectedLabelFont：未选中文本标签的字体，若为 nil 则使用 labelFont。
• labels：用于绘制标签的 UIView 数组。

方法

• initWithPoint:leftTitle:buttons:：初始化方法，指定左标题和按钮。
• setSelectedItem:animated:：设置选中的项目，支持动画效果。
• setExpanded:animated:：设置按钮的展开状态，支持动画效果。
• setLeftTitle:：设置左标题视图，支持 NSString、UIImage 或任何 UIView。
• setButtons:：设置按钮视图，支持 NSString、UIImage 或任何 UIView。
• disableTimeout：禁用超时收缩功能。
• updateDisplay：修改按钮参数后，调用此方法更新按钮显示。

协议

• DDExpandableButtonViewSource：用于指定标题或不同按钮时的协议。
  • defaultFrameSize：返回视图的默认框架大小。
  • setHighlighted:：可选方法，用于更改选中项目的外观。

4. 项目安装方式

手动安装

1. 下载 DDExpandableButton 类文件。
2. 将 DDExpandableButton.h 和 DDExpandableButton.m 文件添加到您的 Xcode 项目中。
3. 根据项目需求配置编译标志（ARC 或非 ARC）。

使用示例

NSArray *buttons = [NSArray arrayWithObjects:@"Black", @"Red", @"Green", @"Blue", nil];
DDExpandableButton *colorButton = [[[DDExpandableButton alloc] initWithPoint:CGPointMake(20, 70) leftTitle:@"Color" buttons:buttons] autorelease];
[[self view] addSubview:colorButton];
[colorButton addTarget:self action:@selector(toggleColor:) forControlEvents:UIControlEventValueChanged];

通过以上步骤，您可以成功安装并使用 DDExpandableButton 项目。