一個(gè)UIButton的實(shí)例變量， 使一個(gè)按鈕(button)在觸摸屏上生效。一個(gè)按鈕監(jiān)聽觸摸事件，當(dāng)被點(diǎn)擊時(shí)，給目標(biāo)對(duì)象發(fā)送一個(gè)動(dòng)作（action）消息。設(shè)置目標(biāo)對(duì)象的方法和動(dòng)作繼承于UIControl。UIButton類提供設(shè)置一個(gè)按鈕的標(biāo)題（title），圖片（image），和其他外形屬性的方法。通過使用這些函數(shù)，你可以為每一個(gè)按鈕狀態(tài)指定不同的外觀顯示。

關(guān)于基本視圖行為的信息，請(qǐng)參考? View Programming Guide for iOS。

關(guān)于更多外形和行為配置的信息，請(qǐng)參考Button。

一、創(chuàng)建Buttons

語法：+(instancetype)buttonWithType:(UIButtonType)buttonType

參數(shù)說明：

buttonType：按鈕類型。可以使用的值：詳細(xì)請(qǐng)參照UIButtonType

typedefenum{

UIButtonTypeCustom=0,

UIButtonTypeSystem,

UIButtonTypeDetailDisclosure,

UIButtonTypeInfoLight,

UIButtonTypeInfoDark,

UIButtonTypeContactAdd,

UIButtonTypeRoundedRect,

}UIButtonType;

Constants

UIButtonTypeCustom

No button style.

Available in iOS 2.0 and later.

UIButtonTypeSystem

A system style button, such as those shown in navigation bars and toolbars.

Available in iOS 7.0 and later.

UIButtonTypeDetail

DisclosureA detail disclosure button.

Available in iOS 2.0 and later.

UIButtonTypeInfoLight

An information button that has a light background.

Available in iOS 2.0 and later.

UIButtonTypeInfoDark

An information button that has a dark background.

Available in iOS 2.0 and later.

UIButtonTypeContact

AddA contact add button.

Available in iOS 2.0 and later.

UIButtonTypeRoundedRect

A rounded-rectangle style button.

Use UIButtonTypeSystem instead. Deprecated in iOS 7.0.

返回值：返回一個(gè)新創(chuàng)建的按鈕

討論：

這個(gè)方式是使用特定配置創(chuàng)建按鈕對(duì)象的便利構(gòu)造器。如果你繼承UIButton，這個(gè)方法不會(huì)返回你的子類的一個(gè)實(shí)例變量。如果你想要為一個(gè)特定的子類創(chuàng)建一個(gè)實(shí)例變量，你必須直接alloc/init這個(gè)按鈕。

當(dāng)創(chuàng)建一個(gè)自定義按鈕時(shí)（類型是 UIButtonTypeCustom的按鈕），這個(gè)按鈕的框架被初始化為(0, 0, 0, 0)。在將按鈕添加到界面之前，你應(yīng)該使用適當(dāng)?shù)膮?shù)，更新該按鈕的框架。

二、配置按鈕的標(biāo)題

1. titleLabel （Property）

一個(gè)視圖，用于為一個(gè)button顯示 currentTitle 的參數(shù)（read-only）

語法定義：@propety(nonatomic, readonly, strong) UILabel *titleLabel

討論

雖然這個(gè)屬性是read-only，但是他們自己的修改特性（setter與getter方法）是read-write。首先使用他們的修改特性（setter與getter方法）來配置一個(gè)button的文本。例如：

UIButton*button= [UIButton buttonWithType:UIButtonTypeSystem];

button.titleLabel.font= [UIFont systemFontOfSize:12];

button.titleLabel.lineBreakMode=NSLineBreakByTruncatingTail;

不要使用標(biāo)簽對(duì)象（the label object）設(shè)置文字顏色或者顏色陰影。而是使用這個(gè)類（UIButton）中的 setTitleColor:forState: 和 setTitleShadowColor:forState: 方法來改變那些參數(shù)。

即使按鈕還沒有被顯示，titleLabel屬性也返回一個(gè)數(shù)值。對(duì)于system button，這個(gè)屬性的值是：nil。

2. -titleForState:

返回與指定狀態(tài)相關(guān)的標(biāo)題。

語法：-（NSString*）titleForState:(UIControlState)state

參數(shù)：

state：使用標(biāo)題的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

返回值：

指定狀態(tài)的標(biāo)題。如果沒有為指定狀態(tài)設(shè)置標(biāo)題，這個(gè)方法返回與 UIControlStateNormal 狀態(tài)相關(guān)的標(biāo)題。

3. -setTitle:forState:

為指定狀態(tài)設(shè)置標(biāo)題

語法：-(void)seTitle:(NSString *)title forState:(UIControlState)state

參數(shù)：

title：用于指定狀態(tài)的標(biāo)題

state：使用指定標(biāo)題的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

討論

使用這個(gè)方法，為按鈕設(shè)置標(biāo)題。你指定的標(biāo)題格式源于與按鈕相關(guān)的便簽對(duì)象。如果為一個(gè)按鈕既設(shè)置了一個(gè)標(biāo)題，又設(shè)置了一個(gè)屬性化的標(biāo)題，那么按鈕偏向使用那個(gè)被屬性化的標(biāo)題。

至少，你應(yīng)該為normal state狀態(tài)設(shè)置值。如果沒有為一個(gè)狀態(tài)沒有指定title，默認(rèn)行為是：使用與 UIControlStateNormal 相關(guān)的標(biāo)題。如果UIControlStateNormal狀態(tài)的title沒有設(shè)置，那么這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。

4 -attributedTitleForState:

返回與特定狀態(tài)相關(guān)的格式化標(biāo)題（the styled title）

語法：- (NSAttributedString*)attributedTitleForState:(UIControlState)state

參數(shù)：

state：使用該格式化字標(biāo)題的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

返回值：

特定狀態(tài)的標(biāo)題。如果指定的狀態(tài)沒有設(shè)置格式化標(biāo)題，這個(gè)方法將返回與UIControlStateNormal狀態(tài)相關(guān)的格式化標(biāo)題。如果UIControlStateNormal狀態(tài)也沒有設(shè)置格式化標(biāo)題，返回nil。

5.- setAttributedTitle:forState：

語法：- (void)setAttributedTitle:(NSAttributedString*)title?forState:(UIControlState)state

參數(shù)：

title：用于標(biāo)題的格式化文本字符串

state：使用指定標(biāo)題的狀態(tài)。以使用的值：請(qǐng)參考UIControlState的描述。

討論：

使用這個(gè)方法，為按鈕設(shè)置包含所有相關(guān)格式信息的標(biāo)題。如果同時(shí)各按鈕設(shè)置標(biāo)題和格式化標(biāo)題，按鈕會(huì)偏向使用格式化字符。

至少，你應(yīng)該為normal state狀態(tài)設(shè)置值。如果沒有為一個(gè)狀態(tài)沒有指定title，默認(rèn)行為是：使用與 UIControlStateNormal 相關(guān)的標(biāo)題。如果UIControlStateNormal狀態(tài)的title沒有設(shè)置，那么這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。

6 -titleColorForState：

返回用于一個(gè)狀態(tài)的標(biāo)題的顏色

語法：- (UIColor*)titleColorForState:(UIControlState)state

參數(shù)：

state：使用這個(gè)標(biāo)題顏色的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

返回：

指定狀態(tài)下的標(biāo)題的顏色

7. - setTitleColor: forState:

為指定狀態(tài)下的標(biāo)題設(shè)置顏色.

語法：- (void)setTitleColor:(UIColor*)color?forState:(UIControlState)state

參數(shù)：

color：用于設(shè)置指定狀態(tài)下標(biāo)題的顏色

state：使用指定顏色的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

討論：

總的來說， 如果沒有為一個(gè)狀態(tài)指定屬性，默認(rèn)使用UIControlStateNormal的參數(shù)值。如果UIControlStateNormal的參數(shù)值也沒有設(shè)置，則這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。因此，至少你應(yīng)該為the normal state設(shè)置參數(shù)。

8 -titleShadowColorForState:

返回一個(gè)狀態(tài)下標(biāo)題的陰影顏色

語法：- (UIColor*)titleShadowColorForState:(UIControlState)state

參數(shù)：

state：使用該標(biāo)題陰影顏色的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

返回值：

指定狀態(tài)下的標(biāo)題的陰影顏色。

9 -setTitleShadowColor: forState:

為指定狀態(tài)下的標(biāo)題陰影設(shè)置顏色

語法：- (void)setTitleShadowColor:(UIColor*)color?forState:(UIControlState)state

參數(shù)：

color：用于設(shè)置指定狀態(tài)下標(biāo)題陰影的顏色

state：使用指定陰影顏色的狀態(tài)。可以使用的值：請(qǐng)參考UIControlState的描述

討論：

總的來說， 如果沒有為一個(gè)狀態(tài)指定屬性，默認(rèn)使用UIControlStateNormal的參數(shù)值。如果UIControlStateNormal的參數(shù)值也沒有設(shè)置，則這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。因此，至少你應(yīng)該為the normal state設(shè)置參數(shù)。

10 - reversesTitleShadowWhenHighlighted ?(Property)

一個(gè)布爾值，用于決定，當(dāng)按鈕高亮?xí)r，是否更改標(biāo)題陰影。

語法：@property(nonatomic)BOOL reversesTitleShadowWhenHighlighted

討論：

如果是YES，當(dāng)高亮?xí)r，陰影從雕刻外觀編程浮雕外觀。默認(rèn)參數(shù)是：NO。

二、配置按鈕顯示

（Configuring Button Presentation）

1 -adjustsImageWhenHighlighted (property)

一個(gè)布爾數(shù)值，決定當(dāng)一個(gè)按鈕是高亮?xí)r，圖片是否更改

語法：@property(nonatomic)BOOL adjustsImageWhenHighlighted

討論：

如果是：YES，當(dāng)按鈕高亮?xí)r，圖片是灰度。默認(rèn)參數(shù)是YES

2 -adjustsImageWhenDisable (Property)

一個(gè)布爾數(shù)值，決定當(dāng)一個(gè)按鈕是不可用時(shí)，圖片是否更改

語法：@property(nonatomic)BOOL adjustsImageWhenDisabled

討論：

如果是：YES，當(dāng)按鈕不可用時(shí)，圖片加深。默認(rèn)參數(shù)是YES

3 -showsTouchWhenHighlight （Property）

一個(gè)布爾數(shù)值，決定當(dāng)點(diǎn)擊按鈕是否會(huì)導(dǎo)致其發(fā)光

語法：@property(nonatomic)BOOL showsTouchWhenHighlighted

討論：

如果是：YES，當(dāng)按鈕被點(diǎn)擊，按鈕發(fā)光，否則，它將不會(huì)。當(dāng)發(fā)光，圖片與按鈕行為不會(huì)改變。默認(rèn)參數(shù)是NO

4 -backgroundImageForState：

返回一個(gè)按鈕狀態(tài)下的背景圖片

語法：- (UIImage*)backgroundImageForState:(UIControlState)state

參數(shù)：

state：使用該背景圖片的狀態(tài)。可以設(shè)置的值：請(qǐng)參考UIContorlState描述

返回：

返回在指定狀態(tài)下的背景圖片

5 -imageForState：

返回一個(gè)按鈕狀態(tài)下的圖片

語法：- (UIImage*)imageForState:(UIControlState)state

參數(shù)：

state：使用該圖片的狀態(tài)。可以設(shè)置的值：請(qǐng)參考UIControlState描述

返回：

返回指定狀態(tài)下的背景。

6 -setBackgroundImage: forState:

為指定按鈕狀態(tài)設(shè)置背景圖片

語法：- (void)setBackgroundImage:(UIImage*)image?forState:(UIControlState)state

參數(shù)：

image：為指定狀態(tài)使用的背景圖片。

state：使用指定圖片的狀態(tài)。可以設(shè)置的值：請(qǐng)參考UIControlState描述

討論：

總的來說， 如果沒有為一個(gè)狀態(tài)指定屬性，默認(rèn)使用UIControlStateNormal的參數(shù)值。如果UIControlStateNormal的參數(shù)值也沒有設(shè)置，則這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。因此，至少你應(yīng)該為the normal state設(shè)置參數(shù)。

7 - setImage：forState：

為指定按鈕狀態(tài)設(shè)置圖片

語法：- (void)setImage:(UIImage*)image?forState:(UIControlState)state

參數(shù)：

image：為指定狀態(tài)使用的背景圖片。

state：使用指定圖片（原文是：標(biāo)題？？）的狀態(tài)。可以設(shè)置的值：請(qǐng)參考UIControlState描述

討論：

總的來說， 如果沒有為一個(gè)狀態(tài)指定屬性，默認(rèn)使用UIControlStateNormal的參數(shù)值。如果UIControlStateNormal的參數(shù)值也沒有設(shè)置，則這個(gè)屬性默認(rèn)為一個(gè)系統(tǒng)參數(shù)。因此，至少你應(yīng)該為the normal state設(shè)置參數(shù)。

8 tintColor （Property）

應(yīng)用給按鈕與圖片的著色顏色值

http://www.cocoachina.com/ios/20150703/12363.html

語法：@property(nonatomic,strong)UIColor*tintColor

討論:

在IOS7.0，所有的UIView的子類，他們關(guān)于tintColor的行為，來自于基類。參看the discussion of?tintColor?at the?UIView?level 獲取更多信息

這個(gè)屬性對(duì)類型是UIButtonTypeCustom的按鈕沒有默認(rèn)的效果。對(duì)于custom button，你必須自己實(shí)現(xiàn)關(guān)于tintColor的任何操作。

三、配置內(nèi)邊緣（Configuring Edge Insets）

1. contentEdgeInsets （Property）

所有按鈕的內(nèi)容周圍的矩形的內(nèi)側(cè)或者外側(cè)的邊緣。

語法：@property(nonatomic)UIEdgeInsets?contentEdgeInsets

討論：

使用這個(gè)屬性，重新調(diào)整大小，或者復(fù)位實(shí)際存在的（用于按鈕內(nèi)容的）矩形繪制區(qū)域。這個(gè)內(nèi)容包括按鈕圖片和按鈕標(biāo)題。你能夠?yàn)樗膫€(gè)內(nèi)側(cè)（上，下，左，右）的任意一個(gè)，指定不同是數(shù)值。一個(gè)正值，縮小（或者向凹）這個(gè)邊緣，將它向按鈕中心移動(dòng)。一個(gè)負(fù)值，放大（或者外凸）這個(gè)邊緣。使用UIEdgeInsetsMake函數(shù)為這個(gè)屬相構(gòu)建一個(gè)數(shù)值。默認(rèn)的參數(shù)是UIEdgeInsetZero。

按鈕使用這個(gè)屬性來確定 intrinsicContentSize(固有的內(nèi)容大小）和sizeThatFits：(占用的尺寸）

2.titleEdgeInsets （Property）

在按鈕標(biāo)題文本周圍矩形的，向內(nèi)或者向外的邊緣。

語法：@property(nonatomic)UIEdgeInsets?titleEdgeInsets

討論：

使用這個(gè)屬性，重新調(diào)整大小，或者復(fù)位實(shí)際存在的（用于按鈕標(biāo)題的）矩形繪制區(qū)域。你能夠?yàn)樗膫€(gè)內(nèi)側(cè)（上，下，左，右）的任意一個(gè)，指定不同是數(shù)值。一個(gè)正值，縮小（或者向凹）這個(gè)邊緣，將它向按鈕中心移動(dòng)。一個(gè)負(fù)值，放大（或者外凸）這個(gè)邊緣。使用UIEdgeInsetsMake函數(shù)為這個(gè)屬相構(gòu)建一個(gè)數(shù)值。默認(rèn)的參數(shù)是UIEdgeInsetZero。

在一個(gè)標(biāo)題矩形已經(jīng)被設(shè)置好適合按鈕文本后，你又為它指定內(nèi)邊距，正值的內(nèi)邊距，實(shí)際上會(huì)剪掉標(biāo)題文本。（即：文本顯示不全）。

這個(gè)屬性只用來定位標(biāo)題在布局中的位置，按鈕不使用這個(gè)屬性來確定 intrinsicContentSize(固有的內(nèi)容大小）和sizeThatFits：(占用的尺寸）

3.imageEdgeInsets (Property)

屬于按鈕圖片周圍矩形的，向內(nèi)或者向外的邊緣

語法：@property(nonatomic)UIEdgeInsets?imageEdgeInsets

使用這個(gè)屬性，重新調(diào)整大小，或者復(fù)位實(shí)際存在的（用于按鈕圖片的）矩形繪制區(qū)域。你能夠?yàn)樗膫€(gè)內(nèi)側(cè)（上，下，左，右）的任意一個(gè)，指定不同是數(shù)值。一個(gè)正值，縮小（或者向凹）這個(gè)邊緣，將它向按鈕中心移動(dòng)。一個(gè)負(fù)值，放大（或者外凸）這個(gè)邊緣。使用UIEdgeInsetsMake函數(shù)為這個(gè)屬相構(gòu)建一個(gè)數(shù)值。默認(rèn)的參數(shù)是UIEdgeInsetZero。

這個(gè)屬性只用來定位圖片在布局中的位置，按鈕不使用這個(gè)屬性來確定 intrinsicContentSize(固有的內(nèi)容大小）和sizeThatFits：(占用的尺寸）

四、獲取當(dāng)前狀態(tài)（Getting the Current State）

1. buttonType （Property）

按鈕類型（read-only）

語法：@property(nonatomic,readonly)UIButtonTypebuttonType

討論：

可能參數(shù)，請(qǐng)參照：UIButtonType

2. currentTitle （Property）

被顯示在按鈕上的當(dāng)前標(biāo)題。（read-only)

語法：@property(nonatomic,readonly,strong)NSString*currentTitle

討論：

無論何時(shí)按鈕狀態(tài)改變，這個(gè)屬性的參數(shù)都是自動(dòng)設(shè)置的。當(dāng)按鈕狀態(tài)沒有一個(gè)自定義的標(biāo)題字符串與它相關(guān)聯(lián)，這個(gè)方法返回當(dāng)前顯示的，與UIControlStateNormal狀態(tài)相關(guān)聯(lián)的典型標(biāo)題。這個(gè)參數(shù)可能為nil。

3. currentAttributedTitle （Property）

被顯示在按鈕上的當(dāng)前格式化標(biāo)題

語法：@property(nonatomic,readonly,strong)NSAttributedString*currentAttributedTitle

這個(gè)屬性的參數(shù)反映了標(biāo)題與控制器當(dāng)前狀態(tài)相聯(lián)系，當(dāng)按鈕狀態(tài)沒有一個(gè)自定義的標(biāo)題字符串與它相關(guān)聯(lián)，這個(gè)方法返回當(dāng)前顯示的，與UIControlStateNormal狀態(tài)相關(guān)聯(lián)的典型屬性化標(biāo)題

4.currentTitleColor （Property）

顯示的標(biāo)題的顏色。（read-only）

語法：@property(nonatomic,readonly,strong)UIColor*currentTitleColor

討論：

這個(gè)參數(shù)保證不會(huì)為nil，默認(rèn)的參數(shù)是white。

5.currentTitleShadowColor （Property）

顯示的標(biāo)題陰影的顏色。（read-only）

語法：@property(nonatomic,readonly,strong)UIColor*currentTitleShadowColor

討論：

默認(rèn)的參數(shù)是white。

6.currentImage（Property）

?被顯示在按鈕上的當(dāng)前圖片（read-only）

語法：@property(nonatomic,readonly,strong)UIImage*currentImage

討論：

這個(gè)參數(shù)可以為nil。

7.currentBackgroundImage （ Property）

?被顯示在按鈕上的當(dāng)前背景圖片（read-only）

語法：@property(nonatomic,readonly,strong)UIImage*currentBackgroundImage

討論：

這個(gè)參數(shù)可以為nil。

8. ?imageView (Property)

按鈕的圖片視圖（read-only）

語法：@property(nonatomic,readonly,strong)UIImageView*imageView

?雖然這個(gè)屬性是read-only，但是它自己的屬性方法是read/write。使用這些方法可以配置按鈕視圖的顯示和行為。例如：

UIButton*button= [UIButton buttonWithType:UIButtonTypeSystem];

button.imageView.exclusiveTouch=YES;

這個(gè)imageView屬性返回一個(gè)參數(shù)，即使按鈕尚還沒有被顯示。對(duì)于系統(tǒng)按鈕（system buttons0，這個(gè)屬性參數(shù)是nil。

五、獲得尺寸（Getting Dimensions）

1 -backgroundRectForBounds：

返回消息接收者繪制它的背景在所的矩形區(qū)域。

語法：- (CGRect)backgroundRectForBounds:(CGRect)bounds

參數(shù)：

bounds：消息接收者的邊界矩形

返回值：

返回邊界矩形，在這里去繪制任何標(biāo)準(zhǔn)的按鈕內(nèi)容、

討論：

這個(gè)方法的默認(rèn)執(zhí)行是返回在bounds參數(shù)里的數(shù)值。這個(gè)矩形區(qū)域代表一個(gè)區(qū)域，在這個(gè)區(qū)域，按鈕繪制它的標(biāo)準(zhǔn)背景內(nèi)容。 那些提供自定義背景修飾的子類，可以重寫這個(gè)方法，返回一個(gè)重構(gòu)的矩形邊界，以防止按鈕覆蓋掉任何自定義的內(nèi)容。

2. -contentRectForBounds:

返回一個(gè)矩形，在這個(gè)矩形內(nèi)，消息接受著繪制它的整個(gè)內(nèi)容。

語法：- (CGRect)contentRectForBounds:(CGRect)bounds

參數(shù)：

bounds：消息接收者的邊界矩形

返回：

返回一個(gè)矩形，在這個(gè)矩形內(nèi)，消息接受著繪制它的整個(gè)內(nèi)容。

討論：

這個(gè)內(nèi)容矩形是一片區(qū)域，這片區(qū)域需要顯示圖片和標(biāo)題，包括任何為了校準(zhǔn)和其他設(shè)置所進(jìn)行的添加與調(diào)整。

3. -titleRectForContentRect:

返回一個(gè)矩形，在這個(gè)矩形內(nèi)，消息接受著繪制它的標(biāo)題

語法：- (CGRect)titleRectForContentRect:(CGRect)contentRect

參數(shù)：

contentRect：消息接受者的內(nèi)容矩形

返回：

返回一個(gè)矩形，在這里，消息接受者繪制它的標(biāo)題

4. -imageRectForContentRect:

返回一個(gè)矩形，在這個(gè)矩形內(nèi)，消息接受著繪制它的標(biāo)題

語法：- (CGRect)imageRectForContentRect:(CGRect)contentRect

參數(shù)：

contentRect：消息接受者的內(nèi)容矩形

返回：

返回一個(gè)矩形，在這里，消息接受者繪制它的圖形。

六、數(shù)據(jù)類型

UIButtonType

Specifies the style of a button.

Declaration

typedefenum{

UIButtonTypeCustom=0,

UIButtonTypeSystem,

UIButtonTypeDetailDisclosure,

UIButtonTypeInfoLight,

UIButtonTypeInfoDark,

UIButtonTypeContactAdd,

UIButtonTypeRoundedRect,

}UIButtonType;

Constants

UIButtonType

CustomNo button style.

Available in iOS 2.0 and later.

UIButtonTypeSystem

A system style button, such as those shown in navigation bars and toolbars.

Available in iOS 7.0 and later.

UIButtonTypeDetailDisclosure

A detail disclosure button.

Available in iOS 2.0 and later.

UIButtonTypeInfoLight

An information button that has a light background.

Available in iOS 2.0 and later.

UIButtonTypeInfoDark

An information button that has a dark background.

Available in iOS 2.0 and later.

UIButtonTypeContactAdd

A contact add button.

Available in iOS 2.0 and later.

UIButtonTypeRoundedRect

A rounded-rectangle style button.

Use UIButtonTypeSystem instead.

Deprecated in iOS 7.0.