UIButton(QMUI)

@interface UIButton (QMUI)

typedef NS_ENUM(NSUInteger, QMUICustomizeButtonPropType) {
    QMUICustomizeButtonPropTypeTitle,
    QMUICustomizeButtonPropTypeTitleColor,
    QMUICustomizeButtonPropTypeTitleShadowColor,
    QMUICustomizeButtonPropTypeImage,
    QMUICustomizeButtonPropTypeBackgroundImage,
    QMUICustomizeButtonPropTypeAttributedTitle
};

- (instancetype)qmui_initWithImage:(UIImage *)image title:(NSString *)title;

/**
 * 判断该 button 在特定 UIControlState 下是否设置了属性
 * @note 该方法会对设置了任何 QMUICustomizeButtonPropType 都返回 YES
 */
- (BOOL)qmui_hasCustomizedButtonPropForState:(UIControlState)state;

/**
 * 判断该 button 在特定 UIControlState 下是否设置了某个 QMUICustomizeButtonPropType 属性
 * @param type 对应于 UIbutton 的 setXXX:forState 办法
 */
- (BOOL)qmui_hasCustomizedButtonPropWithType:(QMUICustomizeButtonPropType)type forState:(UIControlState)state;

/**
 * 在UIButton的样式（如字体）设置完后，将button的text设置为一个测试字符，再调用sizeToFit，从而令button的高度适应字体
 * @warning 会调用<i>setText:forState:</i>，因此请确保在设置完按钮的样式之后、设置text之前调用
 */
- (void)qmui_calculateHeightAfterSetAppearance;

/**
 * 通过这个方法设置了 attributes 之后，setTitle:forState: 会自动把文字转成 attributedString 再添加上去，无需每次都自己构造 attributedString
 * @note 即使先调用 setTitle:forState: 然后再调用这个方法，之前的 title 仍然会被应用上这些 attributes
 * @note 该方法和 setTitleColor:forState: 均可设置字体颜色，如果二者冲突，则代码顺序较后的方法定义的颜色会最终生效
 * @note 如果包含了 NSKernAttributeName ，则此方法会自动帮你去掉最后一个字的 kern 效果，否则容易导致文字整体在视觉上不居中
 */
- (void)qmui_setTitleAttributes:(NSDictionary<NSAttributedStringKey, id> *)attributes forState:(UIControlState)state;

@end

Undocumented

  • Undocumented

    Declaration

    Objective-C

    - (instancetype)qmui_initWithImage:(UIImage *)image title:(NSString *)title;

    Swift

    func qmui_init(with image: UIImage!, title: String!) -> Self!

  • 判断该 button 在特定 UIControlState 下是否设置了属性

    Note

    该方法会对设置了任何 QMUICustomizeButtonPropType 都返回 YES

    Declaration

    Objective-C

    - (BOOL)qmui_hasCustomizedButtonPropForState:(UIControlState)state;

    Swift

    func qmui_hasCustomizedButtonProp(for state: UIControl.State) -> Bool

  • 判断该 button 在特定 UIControlState 下是否设置了某个 QMUICustomizeButtonPropType 属性

    Declaration

    Objective-C

    - (BOOL)qmui_hasCustomizedButtonPropWithType:(QMUICustomizeButtonPropType)type
                                    forState:(UIControlState)state;

    Swift

    func qmui_hasCustomizedButtonProp(with type: QMUICustomizeButtonPropType, for state: UIControl.State) -> Bool

    Parameters

    type

    对应于 UIbutton 的 setXXX:forState 办法

  • 在UIButton的样式（如字体）设置完后，将button的text设置为一个测试字符，再调用sizeToFit，从而令button的高度适应字体

    Warning

    会调用setText:forState:，因此请确保在设置完按钮的样式之后、设置text之前调用

    Declaration

    Objective-C

    - (void)qmui_calculateHeightAfterSetAppearance;

    Swift

    func qmui_calculateHeightAfterSetAppearance()

  • 通过这个方法设置了 attributes 之后，setTitle:forState: 会自动把文字转成 attributedString 再添加上去，无需每次都自己构造 attributedString

    Note

    即使先调用 setTitle:forState: 然后再调用这个方法，之前的 title 仍然会被应用上这些 attributes

    Note

    该方法和 setTitleColor:forState: 均可设置字体颜色，如果二者冲突，则代码顺序较后的方法定义的颜色会最终生效

    Note

    如果包含了 NSKernAttributeName ，则此方法会自动帮你去掉最后一个字的 kern 效果，否则容易导致文字整体在视觉上不居中

    Declaration

    Objective-C

    - (void)qmui_setTitleAttributes:
            (NSDictionary<NSAttributedStringKey, id> *)attributes
                       forState:(UIControlState)state;

    Swift

    func qmui_setTitleAttributes(_ attributes: [NSAttributedString.Key : Any]! = [:], for state: UIControl.State)