iOS: 工具栏控件UIToolBar和工具栏按钮控件UIBarButtonItem的使用

一、工具栏控件：UIToolBar：UIView

介绍：

ToolBar工具栏是视图View的属性,可以在工具栏上添加工具栏按钮Bar Button Item(可以是自定义的Custom、也可以是系统自带的BarButtonSystemItem )，视图控制器可以通过工具栏项对视图中内容进行操作。

 

注意事项：

在导航栏控制器中会有一个UIToolBar实例,但默认是隐藏的，如果需要显示，需要通过这个方法将其打开：

在这里需要注意的是，与UINavigationBar类似,导航控制器拥有且只拥有一个UIToolBar实例,但UIToolBar拥有的UIBarButtonItem实例，是由视图控制器进行管理的，如下所示：

 

工具栏风格：

typedef NS_ENUM(NSInteger, UIBarStyle) {

UIBarStyleDefault          = 0,        //默认风格，蓝色文字

UIBarStyleBlack            = 1,        //黑色背景，褐色文字

UIBarStyleBlackOpaque      = 1,    // 纯黑色背景,白色文字

UIBarStyleBlackTranslucent = 2,   // 透明黑色背景,白色文字

};

 

属性：

@property(nonatomic)        UIBarStyle barStyle;    //工具栏风格，默认为蓝色

@property(nonatomic,copy)   NSArray   *items;     //工具栏中的按钮单元,UIBarButtonItem

@property(nonatomic,assign,getter=isTranslucent) BOOL translucent  //是否透明

@property(nonatomic,retain) UIColor *tintColor;        //按钮颜色

@property(nonatomic,retain) UIColor *barTintColor； //工具栏颜色

方法：

※设置工具栏中的按钮单元

- (void)setItems:(NSArray *)items animated:(BOOL)animated;

※设置工具栏的背景图像

- (void)setBackgroundImage:(UIImage *)backgroundImage forToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics;

※获取工具栏的背景图像

- (UIImage *)backgroundImageForToolbarPosition:(UIBarPosition)topOrBottom barMetrics:(UIBarMetrics)barMetrics;

※设置工具栏的阴影图像

- (void)setShadowImage:(UIImage *)shadowImage forToolbarPosition:(UIBarPosition)topOrBottom;

※获取工具栏的阴影图像

- (UIImage *)shadowImageForToolbarPosition:(UIBarPosition)topOrBottom ;

二、工具栏按钮控件：UIBarButtonItem:UIBarItem

属性：

@property(nonatomic)         UIBarButtonItemStyle style;            //风格

@property(nonatomic)         CGFloat              width;                // 调节间距宽度

@property(nonatomic,copy)    NSSet               *possibleTitles;   // 标题

@property(nonatomic,retain)  UIView              *customView;       // 自定义视图

@property(nonatomic)         SEL                  action;                // 事件

@property(nonatomic,assign)  id                   target;      // 目标代理

按钮单元风格UIBarButtonItem：

typedef NS_ENUM(NSInteger, UIBarButtonItemStyle) {

UIBarButtonItemStylePlain,        //普通风格

UIBarButtonItemStyleBordered,  //有边界的风格

UIBarButtonItemStyleDone,       //蓝色风格

};

系统自带的按钮：

typedef NS_ENUM(NSInteger, UIBarButtonSystemItem) {

UIBarButtonSystemItemDone,            //确认按钮

UIBarButtonSystemItemCancel,          //取消按钮

UIBarButtonSystemItemEdit,             //编辑按钮

UIBarButtonSystemItemSave,            // 保存按钮

UIBarButtonSystemItemAdd,             //添加按钮

UIBarButtonSystemItemFlexibleSpace,//自动调节间距按钮

UIBarButtonSystemItemFixedSpace,   //自定义调节间距按按钮

UIBarButtonSystemItemCompose,

UIBarButtonSystemItemReply,

UIBarButtonSystemItemAction,

UIBarButtonSystemItemOrganize,

UIBarButtonSystemItemBookmarks,

UIBarButtonSystemItemSearch,

UIBarButtonSystemItemRefresh,

UIBarButtonSystemItemStop,

UIBarButtonSystemItemCamera,

UIBarButtonSystemItemTrash,

UIBarButtonSystemItemPlay,

UIBarButtonSystemItemPause,

UIBarButtonSystemItemRewind,

UIBarButtonSystemItemFastForward,

UIBarButtonSystemItemUndo,

UIBarButtonSystemItemRedo,

UIBarButtonSystemItemPageCurl,

};

主要方法：

※用图像初始化

- (instancetype)initWithImage:(UIImage *)image style:(UIBarButtonItemStyle)style target:(id)target action:(SEL)action;

※图片(包括竖屏和横屏显示不同的图片)

- (instancetype)initWithImage:(UIImage *)image landscapeImagePhone:(UIImage *)landscapeImagePhone style:(UIBarButtonItemStyle)style target:(id)target action:(SEL)action;

※用字符串初始化

- (instancetype)initWithTitle:(NSString *)title style:(UIBarButtonItemStyle)style target:(id)target action:(SEL)action;

※用系统按钮初始化

- (instancetype)initWithBarButtonSystemItem:(UIBarButtonSystemItem)systemItem target:(id)target action:(SEL)action;

※用自定义图像初始化

- (instancetype)initWithCustomView:(UIView *)customView;

举例举例如下：

1.在工具栏中全部添加系统自带的按钮单元：

   //创建toolBal导航栏实例
    UIToolbar *toolbar = [[UIToolbar alloc]initWithFrame:CGRectMake(, -, , )];

    //设置toolBar风格
    toolbar.barStyle =  UIBarStyleBlack;

    //将该控件添加到视图中
    [self.view addSubview:toolbar];

    //创建控件上的按钮单元
    UIBarButtonItem *additem = [[UIBarButtonItem alloc]initWithBarButtonSystemItem:UIBarButtonSystemItemAdd target:self action:nil];

    UIBarButtonItem *edititem = [[UIBarButtonItem alloc]initWithBarButtonSystemItem:UIBarButtonSystemItemEdit target:self action:nil];

    UIBarButtonItem *titleitem = [[UIBarButtonItem alloc]initWithTitle:@"title" style:UIBarButtonItemStyleDone target:self action:nil];

    //创建灵活调节按钮单元,设置间隔
    UIBarButtonItem *flexibleitem = [[UIBarButtonItem alloc]initWithBarButtonSystemItem:(UIBarButtonSystemItemFlexibleSpace) target:self action:nil];

    //将按钮单元都添加到数组中
    NSArray *items = @[additem,flexibleitem,edititem,flexibleitem,titleitem];

    //设置导航栏上的按钮单元
    [toolbar setItems:items animated:YES];

演示结果如下：

2.在工具栏上添加图像按钮

   //创建toolBal导航栏实例
    UIToolbar *toolbar = [[UIToolbar alloc]initWithFrame:CGRectMake(, , , )];

    //设置toolBar风格
    toolbar.barStyle =  UIBarStyleDefault;

    //将该控件添加到视图中
    [self.view addSubview:toolbar];

    //创建控件上的按钮单元
    UIBarButtonItem *imageitem1 = [[UIBarButtonItem alloc]initWithImage:[UIImage imageNamed:@"1.png"] style:UIBarButtonItemStylePlain target:self action:nil];

    UIBarButtonItem *imageitem2 = [[UIBarButtonItem alloc]initWithImage:[UIImage imageNamed:@"2.png"] style:UIBarButtonItemStylePlain target:self action:nil];

    UIBarButtonItem *imageitem3 = [[UIBarButtonItem alloc]initWithImage:[UIImage imageNamed:@"3.png"] style:UIBarButtonItemStylePlain target:self action:nil];

    //创建灵活调节按钮单元,设置间隔
    UIBarButtonItem *flexibleitem = [[UIBarButtonItem alloc]initWithBarButtonSystemItem:(UIBarButtonSystemItemFlexibleSpace) target:self action:nil];

    //将按钮单元都添加到数组中
    NSArray *items = @[imageitem1,flexibleitem,imageitem2,flexibleitem,imageitem3];

    //设置导航栏上的按钮单元
    [toolbar setItems:items animated:YES];

演示结果如下: