iOS - UIButton

前言

    NS_CLASS_AVAILABLE_IOS(2_0) @interface UIButton : UIControl <NSCoding>
    @available(iOS 2.0, *)       public class UIButton : UIControl, NSCoding

1、UIButton 的创建

  • Objective-C

        // 实例化 button 对象
        UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
    
        // 将 button 添加到 window
        [self.view addSubview:button];
  • Swift

        // 实例化 button 对象
        let button:UIButton = UIButton(type: .Custom)
    
        // 将 button 添加到 window  
        self.view.addSubview(button)

2、UIButton 的设置

  • Objective-C

        // 设置 button 类型
        /*
            UIButtonTypeCustom = 0,         // 定制按钮,不带图标(常加载图片),默认文字颜色为白色,无触摸时的高亮效果
            UIButtonTypeSystem              // 不带图标,默认文字颜色为蓝色,有触摸时的高亮效果
            UIButtonTypeDetailDisclosure,   // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            UIButtonTypeInfoLight,          // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            UIButtonTypeInfoDark,           // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            UIButtonTypeContactAdd,         // “+” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            UIButtonTypeRoundedRect = UIButtonTypeSystem,
    
            [[UIButton alloc] init] 方式创建的 button 为 UIButtonTypeCustom 类型。
            StoryBoard 创建的 button 默认为 UIButtonTypeSystem 类型。
        */
        UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
    
        // 设置 frame
        button.frame = CGRectMake(10, 100, 110, 50);
    
        // 设置内边距大小
        /*
            设置的内边距范围内不会显示内容
        */
    
            // 内容内边距(标题文字和图片)
            button.contentEdgeInsets = UIEdgeInsetsMake(20, 20, 10, 10);
    
            // 标题文字内边距
            button.titleEdgeInsets = UIEdgeInsetsMake(40, 20, 10, 10);
    
            // 图片内边距
            button.imageEdgeInsets = UIEdgeInsetsMake(20, 10, 10, 10);
    
        // 背景颜色
        /*
            默认为透明色(clearColor)
        */
        button.backgroundColor = [UIColor grayColor];
    
        // 设置按钮的文字
        /*
            UIControlStateNormal       = 0,           // 未选中状态,常规状态
            UIControlStateHighlighted  = 1 << 0,      // 高亮状态,点击状态
            UIControlStateDisabled     = 1 << 1,      // 禁用状态
            UIControlStateSelected     = 1 << 2,      // flag usable by app (see below),选中状态
            UIControlStateFocused NS_ENUM_AVAILABLE_IOS(9_0) = 1 << 3,    
                                                      // Applicable only when the screen supports focus
            UIControlStateApplication  = 0x00FF0000,  // additional flags available for application use
            UIControlStateReserved     = 0xFF000000   // flags reserved for internal framework use
        */
        [button setTitle:@"普通状态" forState:UIControlStateNormal];
    
        // 设置文字颜色
        [button setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
    
        // 设置文字阴影颜色
        [button setTitleShadowColor:[UIColor yellowColor] forState:UIControlStateNormal];
    
        // 修改文字字体
        button.titleLabel.font = [UIFont systemFontOfSize:30];               // 普通
        button.titleLabel.font = [UIFont boldSystemFontOfSize:30];           // 加粗
        button.titleLabel.font = [UIFont italicSystemFontOfSize:30];         // 斜体(对中文无效)
        button.titleLabel.font = [UIFont fontWithName:@"Zapfino" size:15];   // 设置为指定字体类型的文字
    
        // 修改文字水平对齐方式
        /*
            UIControlContentHorizontalAlignmentCenter = 0,    // 居中
            UIControlContentHorizontalAlignmentLeft   = 1,    // 左对齐
            UIControlContentHorizontalAlignmentRight  = 2,    // 右对齐
            UIControlContentHorizontalAlignmentFill   = 3,    // 分散对齐
        */
        button.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter;
    
        // 修改文字垂直对齐方式
        /*
            UIControlContentVerticalAlignmentCenter  = 0,     // 居中
            UIControlContentVerticalAlignmentTop     = 1,     // 上对齐
            UIControlContentVerticalAlignmentBottom  = 2,     // 下对齐
            UIControlContentVerticalAlignmentFill    = 3,     // 分散对齐
        */
        button.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter;
    
        // 设置内部的小图片
        /*
            图片将会以原始比例显示,button 上的图片和文字可以同时添加
        */
        [button setImage:[UIImage imageNamed:@"hehe.png"] forState:UIControlStateNormal];
    
        // 设置背景图片
        /*
            图片将会填充整个背景
            为了保证高亮状态下的图片正常显示,必须设置按钮的 type 为 custom
        */
        [button setBackgroundImage:[UIImage imageNamed:@"pic1.png"] forState:UIControlStateNormal];
    
        // 设置图片不变暗
        /*
            在未设置触摸状态图片时,触摸状态或禁用状态下图片会变暗
        */
    
            // 触摸状态时图标不变暗
            button.adjustsImageWhenHighlighted = NO;
    
            // 禁用状态时图标不变暗
            button.adjustsImageWhenDisabled = YES;
    
        // 设置 button 的激活与失效状态
        /*
            YES 激活状态,默认状态,NO 失效状态(不可点击)
        */
        button.enabled = YES;
    
        // 设置 butotn 的隐藏与显示状态
        /*
            YES 隐藏状态,NO 显示状态,默认状态
        */
        button.hidden = YES;
    
        // 设置 butotn 的选中状态
        /*
            YES 选中,NO 未选中
        */
        button.selected = YES;
    
        // 获取 butotn 当前的选中状态
        BOOL selected = button.selected;
    
        // readonly 只读属性
    
            NSString *title = button.currentTitle;                                 // 获取按钮当前的标题
            NSAttributedString *attributedTitle = button.currentAttributedTitle;   // 获取按钮当前的标题属性
            UIColor *titleColor = button.currentTitleColor;                        // 获取按钮当前的标题颜色
            UIColor *shadowColor = button.currentTitleShadowColor;                 // 获取按钮当前的标题阴影颜色
            UIImage *currentImage = button.currentImage;                           // 获取按钮当前的图片
            UIImage *backgroundImage = button.currentBackgroundImage;              // 获取按钮当前的背景图片
            NSString *title1 = [button titleForState:UIControlStateNormal];        // 获取按钮指定状态的文字
    
            // 获取按钮指定状态的标题属性
            NSAttributedString *attributedTitle1 = [button attributedTitleForState:UIControlStateNormal];
    
            // 获取按钮指定状态的标题颜色
            UIColor *titleColor1 = [button titleColorForState:UIControlStateNormal];
    
            // 获取按钮指定状态的标题阴影颜色
            UIColor *shadowColor1 = [button titleShadowColorForState:UIControlStateNormal];
    
            // 获取按钮指定状态的图片
            UIImage *currentImage1 = [button imageForState:UIControlStateNormal];
    
            // 获取按钮指定状态的背景图片
            UIImage *backgroundImage1 = [button backgroundImageForState:UIControlStateNormal];
    
        // 设置 button 点击触发事件
        /*
            UIControlEventTouchDown           = 1 <<  0,  // on all touch downs
            UIControlEventTouchDownRepeat     = 1 <<  1,  // on multiple touchdowns (tap count > 1)
            UIControlEventTouchDragInside     = 1 <<  2,
            UIControlEventTouchDragOutside    = 1 <<  3,
            UIControlEventTouchDragEnter      = 1 <<  4,
            UIControlEventTouchDragExit       = 1 <<  5,
            UIControlEventTouchUpInside       = 1 <<  6,
            UIControlEventTouchUpOutside      = 1 <<  7,
            UIControlEventTouchCancel         = 1 <<  8,
    
            UIControlEventValueChanged        = 1 << 12,  // sliders, etc.
            UIControlEventPrimaryActionTriggered NS_ENUM_AVAILABLE_IOS(9_0) = 1 << 13,
                                              // semantic action: for buttons, etc.
    
            UIControlEventEditingDidBegin     = 1 << 16,  // UITextField
            UIControlEventEditingChanged      = 1 << 17,
            UIControlEventEditingDidEnd       = 1 << 18,
            UIControlEventEditingDidEndOnExit = 1 << 19,  // 'return key' ending editing
    
            UIControlEventAllTouchEvents      = 0x00000FFF,  // for touch events
            UIControlEventAllEditingEvents    = 0x000F0000,  // for UITextField
            UIControlEventApplicationReserved = 0x0F000000,  // range available for application use
            UIControlEventSystemReserved      = 0xF0000000,  // range reserved for internal framework use
            UIControlEventAllEvents           = 0xFFFFFFFF
        */
        [button addTarget:self action:@selector(buttonClick:) forControlEvents:UIControlEventTouchUpInside];
  • Swift

        // 设置 button 类型
        /*
            case Custom             // 定制按钮,不带图标(常加载图片),默认文字颜色为白色,无触摸时的高亮效果
            case System             // 不带图标,默认文字颜色为蓝色,有触摸时的高亮效果
    
            case DetailDisclosure   // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            case InfoLight          // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            case InfoDark           // “!” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
            case ContactAdd         // “+” 图标按钮,默认文字颜色为蓝色,有触摸时的高亮效果
    
            UIButton() 方式创建的 button 为 Custom 类型。
            StoryBoard 创建的 button 默认为 System 类型。
        */
        let button:UIButton = UIButton(type: .Custom)
    
        // 设置 frame
        button.frame = CGRectMake(10, 100, 110, 50)
    
        // 设置内边距大小
        /*
            设置的内边距范围内不会显示内容
        */
    
            // 内容内边距(标题文字和图片)
            button.contentEdgeInsets = UIEdgeInsetsMake(20, 20, 10, 10)
    
            // 标题文字内边距
            button.titleEdgeInsets = UIEdgeInsetsMake(40, 20, 10, 10)
    
            // 图片内边距
            button.imageEdgeInsets = UIEdgeInsetsMake(20, 10, 10, 10)
    
        // 背景颜色
        /*
            默认为透明色(clearColor)
        */
        button.backgroundColor = UIColor.grayColor()
    
        // 设置按钮的文字
        /*
            Normal         // 普通状态,未选中状态
            Highlighted    // used when UIControl isHighlighted is set,高亮状态,点击状态
            Disabled       // 禁用状态
            Selected       // flag usable by app (see below),选中状态
    
            @available(iOS 9.0, *)
            Focused        // Applicable only when the screen supports focus
            Application    // additional flags available for application use
            Reserved       // flags reserved for internal framework use
        */
        button.setTitle("普通状态", forState: .Normal)
    
        // 设置文字颜色
        button.setTitleColor(UIColor.blackColor(), forState: .Normal)
    
        // 设置文字阴影颜色
        button.setTitleShadowColor(UIColor.yellowColor(), forState: .Normal)
    
        // 修改文字字体
        button.titleLabel?.font = UIFont.systemFontOfSize(30)           // 普通
        button.titleLabel?.font = UIFont.boldSystemFontOfSize(30)       // 加粗
        button.titleLabel?.font = UIFont.italicSystemFontOfSize(30)     // 斜体(对中文无效)
        button.titleLabel?.font = UIFont(name: "Zapfino", size: 15)     // 设置为指定字体类型的文字
    
        // 修改文字水平对齐方式
        /*
            case Center      // 居中
            case Left        // 左对齐
            case Right       // 右对齐
            case Fill        // 分散对齐
        */
        button.contentHorizontalAlignment = .Center
    
        // 修改文字垂直对齐方式
        /*
            case Center      // 居中
            case Top         // 上对齐
            case Bottom      // 下对齐
            case Fill        // 分散对齐
        */
        button.contentVerticalAlignment = .Center
    
        // 设置内部的小图片
        /*
            图片将会以原始比例显示,button 上的图片和文字可以同时添加
        */
        button.setImage(UIImage(named: "hehe.png"), forState: .Normal)
    
        // 设置背景图片
        /*
            图片将会填充整个背景
            为了保证高亮状态下的图片正常显示,必须设置按钮的 type 为 custom
        */
        button.setBackgroundImage(UIImage(named: "pic1.png"), forState: .Normal)
    
        // 设置图片不变暗
        /*
            在未设置触摸状态图片时,触摸状态或禁用状态下图片会变暗
        */
    
            // 触摸状态时图标不变暗
            button.adjustsImageWhenHighlighted = false
    
            // 禁用状态时图标不变暗
            button.adjustsImageWhenDisabled = false
    
        // 设置 button 的激活与失效状态
        /*
            true 激活状态,默认状态,false 失效状态(不可点击)
        */
        button.enabled = true
    
        // 设置 butotn 的隐藏与显示状态
        /*
            true 隐藏状态,false 显示状态,默认状态
        */
        button.hidden = true
    
        // 设置 butotn 的选中状态
        /*
            true 选中,false 未选中
        */
        button.selected = true
    
        // 获取 butotn 当前的选中状态
        let selected:Bool = button.selected
    
        // readonly 只读属性
    
            let title:String? = button.currentTitle                                   // 获取按钮当前的标题
            let attributedTitle:NSAttributedString? = button.currentAttributedTitle   // 获取按钮当前的标题属性
            let titleColor:UIColor = button.currentTitleColor                         // 获取按钮当前的标题颜色
            let shadowColor:UIColor? = button.currentTitleShadowColor                 // 获取按钮当前的标题阴影颜色
            let currentImage:UIImage? = button.currentImage                           // 获取按钮当前的图片
            let backgroundImage:UIImage? = button.currentBackgroundImage              // 获取按钮当前的背景图片
    
            // 获取按钮指定状态的文字
            let title1:String? = button.titleForState(.Normal)
    
            // 获取按钮指定状态的标题属性
            let attributedTitle1:NSAttributedString? = button.attributedTitleForState(.Normal)
    
            // 获取按钮指定状态的标题颜色
            let titleColor1:UIColor? = button.titleColorForState(.Normal)
    
            // 获取按钮指定状态的标题阴影颜色
            let shadowColor1:UIColor? = button.titleShadowColorForState(.Normal)
    
            // 获取按钮指定状态的图片
            let currentImage1:UIImage? = button.imageForState(.Normal)
    
            // 获取按钮指定状态的背景图片
            let backgroundImage1:UIImage? = button.backgroundImageForState(.Normal)
    
        // 设置 button 点击触发事件
        /*
            TouchDown                  // on all touch downs
            TouchDownRepeat            // on multiple touchdowns (tap count > 1)
            TouchDragInside
            TouchDragOutside
            TouchDragEnter
            TouchDragExit
            TouchUpInside
            TouchUpOutside
            TouchCancel
    
            ValueChanged              // sliders, etc.
    
            @available(iOS 9.0, *)
            PrimaryActionTriggered    // semantic action: for buttons, etc.
    
            EditingDidBegin           // UITextField
            EditingChanged         
            EditingDidEnd          
            EditingDidEndOnExit       // 'return key' ending editing
    
            AllTouchEvents            // for touch events
            AllEditingEvents          // for UITextField
            ApplicationReserved       // range available for application use
            SystemReserved            // range reserved for internal framework use
            AllEvents             
        */
        button.addTarget(self, action: #selector(UiButton.buttonClick(_:)), forControlEvents: .TouchUpInside)

3、Storyboard 中设置

  • 在 Storyboard 场景中设置

    • Button 设置

      iOS - UIButton

      Type 按钮类型
      State Config 按钮状态
      Title 按钮文字
      Font 按钮文字字体
      Text Color 按钮文字颜色
      Shadow Color 按钮文字阴影颜色
      Image 按钮图片
      Background 按钮背景图片
      Shadow Offset 按钮阴影偏移量
      -- Reverses On Highlight
      Drawing
      -- Shows Touch On Highlight
      -- Highlighted Adjusts Image 高亮状态图片不变暗
      -- Disabled Adjusts Image 禁用状态图片不变暗
      Line Break 断行方式
      Edge 边距类型设置
      Inset 内边距大小设置
    • Control 设置

      iOS - UIButton

      Alignment 文字对齐方式
      Content
      -- Selected 选中
      -- Enable 可用
      -- Highlighted 高亮

4、UIButton、UIImageView、UILabel 的选择

  • 特点:

    • UIButton:
      • 既能显示文字,又能显示图片(能显示 2 张图片,背景图片和内容图片)。
      • 长按高亮的时候可以切换图片\文字。
      • 直接通过 addTarget... 方法监听点击。
    • UIImageView:
      • 能显示图片,不能直接通过 addTarget... 方法监听点击。
    • UILabel:
      • 能显示文字,不能直接通过 addTarget... 方法监听点击。
  • 选择:

    • 仅仅是显示数据,不需要点击
      • 建议选择 UIImageView、UILabel。
    • 不仅显示数据,还需要监听点击
      • 建议选择 UIButton。
        • 其实 UIImageView、UILabel 也可以通过手势识别器来监听。
    • 长按控件后,会改变显示的内容
      • 选择 UIButton
        • 因为 UIButton 有 highlighted 这种状态。
    • 同时显示 2 张图片:背景图片、内容图片
      • 选择 UIButton。

5、UIButton 子控件

  • 1、不要直接拿出按钮内部的子控件,来修改文字、图片属性,按钮内部的子控件设置是有状态的。

    • 直接拿出设置时无法显示

          self.imageView.image = [UIImage imageNamed:@"shop.icon"];
          self.titleLabel.text = shop.name;
    • 带状态设置时才能正常显示

          self setImage:[UIImage imageNamed:shop.icon] forState:UIControlStateNormal];
          [self setTitle:shop.name forState:UIControlStateNormal];
  • 2、子控件 frame 设置

        self.imageView.frame = CGRectMake(0, 0, buttonW, imageH);
        self.titleLabel.frame = CGRectMake(0, imageH, buttonW, buttonH - imageH);
        // 设置按钮中 title 的尺寸
        - (CGRect)titleRectForContentRect:(CGRect)contentRect {
            return CGRectMake(0, 30, 70, 30);
        }
        // 设置按钮中 imageView 的尺寸
        - (CGRect)imageRectForContentRect:(CGRect)contentRect {
    
            // 计算 imageView 控件尺寸,contentRect 为按钮的尺寸
            CGFloat W = 40;
            CGFloat H = 46;
            CGFloat X = (contentRect.size.width - W) * 0.5;
            CGFloat Y = 20;
    
            return CGRectMake(X, Y, W, H);
        }
  • 3、子控件 接收点击事件的区域 设置

        // 设置按钮接收点击事件的区域
        - (UIView *)hitTest:(CGPoint)point withEvent:(UIEvent *)event {
    
            CGFloat btnW = self.bounds.size.width;
            CGFloat btnH = self.bounds.size.height;
    
            // 计算不接收点击事件的区域
            CGFloat X = 0;
            CGFloat Y = btnH / 2;
            CGFloat W = btnW;
            CGFloat H = Y;
            CGRect rect = CGRectMake(X, Y, W, H);
    
            if (CGRectContainsPoint(rect, point)) {
                return nil;
            } else {
                return [super hitTest:point withEvent:event];
            }
        }
上一篇:iOS - UIToolbar


下一篇:iOS - UISwitch