UIStepper

在iOS5中增加了一个UIStepper的新控件，UIStepper可以连续增加或减少一个数值。控件的外观是两个水平并排的按钮构成，一个显示为“+”，一个显示为“-”。如下图所示：

该控件一个有趣的特征是当用户按住“+”“-”按钮时，根据按住的时间长度，控件值的数字也以不同的数字改变。按住的时间越长，数值改变的越快。可以为UIStepper设定一个数值范围，比如0-99。

下面是UIStepper应用范例代码：

01	// Create a label to show the value in the stepper

02	label = [[UILabel alloc] initWithFrame:CGRectMake(10, 20, 100, 30)];

03	[label setTextColor:[UIColor whiteColor]];

04	[label setBackgroundColor:[UIColor clearColor]];

05	[label setTextAlignment:UITextAlignmentLeft];

06	[label setText: @"Quantity:"];

07	[[self view] addSubview:label];

08

09	// Frame defines location, size values are ignored

10	UIStepper *stepper = [[UIStepper alloc] initWithFrame:CGRectMake(120, 20, 0, 0)];

11

12	// Set action target and action for a particular value changed event

13	[stepper addTarget:self action:@selector(stepperPressed:) forControlEvents:UIControlEventValueChanged];

14

15	// Set min and max

16	[stepper setMinimumValue:0];

17	[stepper setMaximumValue:99];

18

19	// Value wraps around from minimum to maximum

20	[stepper setWraps:YES];

21

22	// If continuos (default), changes are sent for each change in stepper,

23	// otherwise, change event occurs once user lets up on button

24	[stepper setContinuous:NO];

25

26	// To change the increment value for each step

27	// (default is 1)

28	[stepper setStepValue:10];

UIStepper是一个类似UISwitch的控件，但是左右两边是一个加号和一个减号

这是iOS 5 新增的控件

文档中的一些属性和方法：

配置 Stepper

•   continuous  属性  BOOL类型，默认YES，YES时表示当用户交互时会立刻发送ValueChange事件，NO则是只有等用户交互
• 结束时才发送ValueChange事件
•   autorepeat  属性  BOOL类型，默认YES，YES时表示按住加号或减号不松手，数字会持续变化
•   wraps  属性 BOOL类型，默认NO，YES时当value加的超过maximumValue，value将变成minimumValue的值，当减的
• 比minimumValue还小，则value变成maximum的值。如果设成NO，这value不会超过最大和最小值
•   minimumValue  属性 Double型 默认为0，最小值，当设置值大于或等于maximumValue时会报一个NSInvalidArgumentException异常
•   maximumValue  属性 Double型 默认为100，是Stepper的最大值，当设置小于或等于minimumValue时会报一个
• NSInvalidArgumentException异常
•   stepValue  属性  Double型 默认为1，Stepper的增量或者步数(例如stepValue 是10，则点一下加就加10，减也是减10)，
• 必须大于0，否则会报一个NSInvalidArgumentException异常
• 访问 Stepper的值
•   value  属性 Double型 默认是0，上限是maximumValue 下限是minimumValue，当数值改变时，会发送
• UIControlValueEventChanged给目标
• 定制化外观
•   tintColor  属性 UIColor型，默认是nil，iOS 6新增

• - (UIImage *)backgroundImageForState:(UIControlState)state
• 什么状态时用什么背景图片，iOS 6新增

• UIControlState 有六个枚举变量
  

  enum {
  

     UIControlStateNormal               = 0,         正常情况
     UIControlStateHighlighted          = 1 << 0,    在作用域内点击但是没有松手
     UIControlStateDisabled             = 1 << 1,    禁止使用时
     UIControlStateSelected             = 1 << 2,    点击且松手一般是按钮按下且凹陷的状态
     UIControlStateApplication          = 0x00FF0000,额外的状态当应用程序使用时
     UIControlStateReserved             = 0xFF000000 内部框架使用
  };
  

• - (void)setBackgroundImage:(UIImage *)image forState:(UIControlState)state
• 最好图片是可伸缩的 iOS 6新增
• 
  
• - (UIImage *)decrementImageForState:(UIControlState)state
• iOS 6新增
• - (void)setDecrementImage:(UIImage *)image forState:(UIControlState)state
• iOS 6新增
• 减号按钮的图片
• 
  
• - (UIImage *)incrementImageForState:(UIControlState)state
• iOS 6新增
• - (void)setIncrementImage:(UIImage *)image forState:(UIControlState)state
• iOS 6新增
• 加号按钮的图片
• 
  
• - (UIImage *)dividerImageForLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState
• leftState是左边的那个按钮的状态，rightState是右边那个按钮的状态
• 两个按钮不同状态时换控件图片，iOS 6新增
• - (void)setDividerImage:(UIImage *)image forLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState
• iOS 6新增

例子：

testStepper.stepValue = 10;

testStepper.minimumValue = 0;

testStepper.maximumValue = 55;

testStepper.value = 10;

testStepper.tintColor = [UIColor redColor];

testStepper.wraps = YES;

一开始就一直点加，则值的变化为 20 30 40 50 55

一开始就一直点减，则值的变化为 0 

当到达上限或下限时，且wraps没有设置成YES,则相应的加或减的按钮会disable