UISegmentedControl方法与属性的总结
SegmentedControl又被称作分段控制器,是IOS开发中经常用到的一个UI控件。
初始化方法:传入的数组可以是字符串也可以是UIImage对象的图片数组
- (instancetype)initWithItems:(NSArray *)items;
设置控件风格:
@property(nonatomic) UISegmentedControlStyle segmentedControlStyle
注意:这个属性已经废弃,不再起任何作用,它的枚举如下:
1
2
3
4
5
6
|
typedef NS_ENUM(NSInteger, UISegmentedControlStyle) { UISegmentedControlStylePlain, // large plain UISegmentedControlStyleBordered, // large bordered UISegmentedControlStyleBar, // small button/nav bar style. tintable UISegmentedControlStyleBezeled, // DEPRECATED. Do not use this style. } NS_DEPRECATED_IOS(2_0, 7_0, "The segmentedControlStyle property no longer has any effect" ); |
设置是否保持选中状态:
@property(nonatomic,getter=isMomentary) BOOL momentary;
注意:如果设置为YES,点击结束后,将不保持选中状态,默认为NO
获取标签个数:(只读)
@property(nonatomic,readonly) NSUInteger numberOfSegments;
设置标签宽度是否随内容自适应:
@property(nonatomic) BOOL apportionsSegmentWidthsByContent;
注意:如果设置为NO,则所有标签宽度一致,为最大宽度。
插入文字标签在index位置:
- (void)insertSegmentWithTitle:(NSString *)title atIndex:(NSUInteger)segment animated:(BOOL)animated
插入图片标签在index位置
- (void)insertSegmentWithImage:(UIImage *)image atIndex:(NSUInteger)segment animated:(BOOL)animated
根据索引删除标签
- (void)removeSegmentAtIndex:(NSUInteger)segment animated:(BOOL)animated;
删除所有标签
- (void)removeAllSegments;
重设标签标题
- (void)setTitle:(NSString *)title forSegmentAtIndex:(NSUInteger)segment;
获取标签标题
- (NSString *)titleForSegmentAtIndex:(NSUInteger)segment;
设置标签图片
- (void)setImage:(UIImage *)image forSegmentAtIndex:(NSUInteger)segment;
获取标签图片
- (UIImage *)imageForSegmentAtIndex:(NSUInteger)segment;
注意:标题的图片只能设置一个
根据索引设置相应标签宽度
- (void)setWidth:(CGFloat)width forSegmentAtIndex:(NSUInteger)segment;
注意:如果设置为0.0,则为自适应,默认为此设置。
根据索引获取标签宽度
- (CGFloat)widthForSegmentAtIndex:(NSUInteger)segment;
设置标签内容的偏移量
- (void)setContentOffset:(CGSize)offset forSegmentAtIndex:(NSUInteger)segment;
注意:这个偏移量指的是标签的文字或者图片
根据索引获取变标签内容的偏移量
- (CGSize)contentOffsetForSegmentAtIndex:(NSUInteger)segment;
根据所以设置标签是否有效(默认有效)
- (void)setEnabled:(BOOL)enabled forSegmentAtIndex:(NSUInteger)segment;
根据索引获取当前标签是否有效
- (BOOL)isEnabledForSegmentAtIndex:(NSUInteger)segment;
设置和获取当前选中的标签索引
@property(nonatomic) NSInteger selectedSegmentIndex;
设置标签风格颜色
@property(nonatomic,retain) UIColor *tintColor;
注意:这个风格颜色会影响标签的文字和图片
设置特定状态下segment的背景图案
- (void)setBackgroundImage:(UIImage *)backgroundImage forState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics
注意:UIBarMetrics是一个枚举,如下:(defaulf风格会充满背景)
1
2
3
4
5
6
7
8
9
|
typedef NS_ENUM(NSInteger, UIBarMetrics) { UIBarMetricsDefault, UIBarMetricsCompact, UIBarMetricsDefaultPrompt = 101, // Applicable only in bars with the prompt property, such as UINavigationBar and UISearchBar UIBarMetricsCompactPrompt, UIBarMetricsLandscapePhone NS_ENUM_DEPRECATED_IOS(5_0, 8_0, "Use UIBarMetricsCompact instead" ) = UIBarMetricsCompact, UIBarMetricsLandscapePhonePrompt NS_ENUM_DEPRECATED_IOS(7_0, 8_0, "Use UIBarMetricsCompactPrompt" ) = UIBarMetricsCompactPrompt, }; |
获取背景图案
- (UIImage *)backgroundImageForState:(UIControlState)state barMetrics:(UIBarMetrics)barMetrics
设置标签之间分割线的图案
- (void)setDividerImage:(UIImage *)dividerImage forLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState barMetrics:(UIBarMetrics)barMetrics
获取标签之间分割线的图案
- (UIImage *)dividerImageForLeftSegmentState:(UIControlState)leftState rightSegmentState:(UIControlState)rightState barMetrics:(UIBarMetrics)barMetrics
通过Attribute字符串属性字典设置标签标题
- (void)setTitleTextAttributes:(NSDictionary *)attributes forState:(UIControlState)state
获取Attribute字符串属性字典
- (NSDictionary *)titleTextAttributesForState:(UIControlState)state
自行设置标签内容的偏移量
- (void)setContentPositionAdjustment:(UIOffset)adjustment forSegmentType:(UISegmentedControlSegment)leftCenterRightOrAlone barMetrics:(UIBarMetrics)barMetrics
注意:UIOffset为偏移量,这个结构体中又两个浮点数,分别表示水平量和竖直量;UISegmentedControlSegment类型参数是一个枚举,如下:
1
2
3
4
5
6
7
|
typedef NS_ENUM(NSInteger, UISegmentedControlSegment) { UISegmentedControlSegmentAny = 0, //所有标签都受影响 UISegmentedControlSegmentLeft = 1, //只有左边部分受到影响 UISegmentedControlSegmentCenter = 2, // 只有中间部分受到影响 UISegmentedControlSegmentRight = 3, // 只有右边部分受到影响 UISegmentedControlSegmentAlone = 4, // 在只有一个标签的时候生效 }; |
获取自定义偏移量
- (UIOffset)contentPositionAdjustmentForSegmentType:(UISegmentedControlSegment)leftCenterRightOrAlone barMetrics:(UIBarMetrics)barMetrics
添加点击事件
1
|
[segmentedControl addTarget:self action:@selector(change:) forControlEvents:UIControlEventValueChanged]; |