UIButton 詳解

轉自：http://blog.csdn.net/jb80400812/article/details/6614184

創建UIButton

UIButton *btn = [UIButton buttonWithType:UIButtonTypeRoundedRect];
btn.frame = CGRectMake(30, 360, 90, 35);
[btn setTitle:@"ZoomIn" forState:UIControlStateNormal];
[btn setTitle:@"ZoomIn" forState:UIControlStateHighlighted];
//@selector可以理解為"選擇子"，selector是一個指針變量，類似於sender。 這里是將method的方法指定給新建的這個btn。 [btn addTarget:self action:@selector(zoomInAction:) forControlEvents:UIControlEventTouchUpInside]; /*在 method 方法里可以將 sender 看作是 btn 了 */
-(void)zoomInAction:(id)sender {}

UIButton

　　從UIControl繼承：UIView的：UIResponder：NSObject的符合NSCoding NSCoding（UIView的）NSObject的（NSObject的）框架/系統/資源庫/框架/ UIKit.framework在iPhone OS 2.0和更高的可用性。聲明UIButton.h相關的代碼示例配件BubbleLevel HeadsUpUI TheElements UICatalog

目錄

• 1 概述
• 兩個 任務
• 三個 屬性
  • 3.1 adjustsImageWhenDisabled
  • 3.2 adjustsImageWhenHighlighted
  • 3.3 按鈕類型
  • 3.4 contentEdgeInsets
  • 3.5 currentImage
  • 3.6 currentTitle
  • 3.7 currentTitleColor
  • 3.8 currentTitleShadowColor
  • 3.9 字體
  • 3.10 imageEdgeInsets
  • 3.11 lineBreakMode
  • 3.12 showsTouchWhenHighlighted
  • 3.13 titleEdgeInsets
  • 3.14 titleShadowOffset
• 4個 參數
  • 4.1 按鈕類型
  • 4.2 backgroundImageForState：
  • 4.3 backgroundRectForBounds：
  • 4.4 contentRectForBounds：

概述

　　UIButton的類是一個UIControl子類，它實現了在觸摸屏上的按鈕。觸摸一個按鈕攔截事件和動作消息發送到目標對象時，它的挖掘。設定的目標和行動方法都繼承自UIControl。這個類提供了方法來設置標題，圖像，按鈕等外觀屬性。通過使用set方法，你可以指定一個不同的外觀為每個按鈕狀態。

 

[  編輯 ]

任務

創建按鈕+ buttonWithType：配置按鈕的標題

 ButtonType屬性字體屬性lineBreakMode財產titleShadowOffset財產reversesTitleShadowWhenHighlighted財產  

- setTitle：forState： - setTitleColor：forState： - setTitleShadowColor：forState： - titleColorForState： - titleForState： - titleShadowColorForState：配置按鈕圖像

 adjustsImageWhenHighlighted財產adjustsImageWhenDisabled財產showsTouchWhenHighlighted財產  

- backgroundImageForState： - imageForState： - setBackgroundImage：forState： - setImage：forState：配置邊緣的Insets

 titleEdgeInsets財產imageEdgeInsets財產contentEdgeInsets財產  

獲取當前狀態

 currentTitle財產currentTitleColor財產currentTitleShadowColor財產currentImage財產currentBackgroundImage財產  

尺寸入門 - backgroundRectForBounds： - contentRectForBounds： - titleRectForContentRect： - imageRectForContentRect：

[  編輯 ]

屬性

Objective - C的屬性，看到的Objective - C 2.0編程語言中的“屬性”。

[  編輯 ]

adjustsImageWhenDisabled

一個布爾值，決定是否形象的變化時，該按鈕被禁用。

@屬性（非原子）BOOL adjustsImageWhenDisabled討論，如果是的話，圖像繪制較深時，按鈕被禁用。默認值是YES。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產adjustsImageWhenHighlighted

在UIButton.h宣布相關的示例代碼BubbleLevel

[  編輯 ]

adjustsImageWhenHighlighted

一個布爾值，決定是否按鈕時，突出顯示圖像的變化。

@屬性（非原子）BOOL adjustsImageWhenHighlighted討論，如果是，繪制圖像較輕的按鈕時，突出顯示。默認值是YES。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產adjustsImageWhenDisabled

在UIButton.h宣布相關的示例代碼BubbleLevel

[  編輯 ]

按鈕類型

按鈕類型。（只讀）

@屬性（非原子，只讀）UIButtonType按鈕類型的討論，見UIButtonType的可能值。

供貨情況在iPhone OS 2.0和更高版本。聲明在UIButton.h

[  編輯 ]

contentEdgeInsets

內容的插圖或一開始就為每個邊緣。

@屬性（非原子）UIEdgeInsets contentEdgeInsets如果每條邊的價值是積極的，指定的插圖，否則，指定一開始。一個插圖是周圍繪制矩形的保證金;每邊（左，右，頂部和底部），可以有不同的值。使用UIEdgeInsetsMake功能設置此屬性。默認值是UIEdgeInsetsZero。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 _AT_財產imageEdgeInsets

宣布UIButton.h currentBackgroundImage按鈕上顯示當前的背景圖像。（只讀）

@屬性（只讀，非原子，保留）的UIImage * currentBackgroundImage討論這個值可以為零。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 _AT_財產currentImage

聲明在UIButton.h

[  編輯 ]

currentImage

當前圖像上顯示的按鈕。（只讀）

@屬性（只讀，非原子，保留）的UIImage * currentImage討論這個值可以為零。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 _AT_財產currentBackgroundImage

聲明在UIButton.h

[  編輯 ]

currentTitle

當前標題，按鈕上顯示的。（只讀）

@屬性（只讀，非原子，保留）的NSString * currentTitle討論這個值可能為零。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產currentTitleColor財產currentTitleShadowColor

聲明在UIButton.h

[  編輯 ]

currentTitleColor

顏色用於顯示標題。（只讀）

@屬性（只讀，非原子，保留）UIColor * currentTitleColor討論這個值是保證不會是零。默認值是白色。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產currentTitle財產currentTitleShadowColor

聲明在UIButton.h

[  編輯 ]

currentTitleShadowColor

標題的陰影的顏色。（只讀）

@屬性（只讀，非原子，保留）UIColor * currentTitleShadowColor討論默認值是白色。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產currentTitle財產currentTitleColor

聲明在UIButton.h

[  編輯 ]

字體

字體用來顯示按鈕上的文字。

@屬性（非原子，保留）UIFont *字體的討論，如果為零，使用系統字體。默認值是零。

供貨情況在iPhone OS 2.0和更高版本。聲明在UIButton.h

[  編輯 ]

imageEdgeInsets

圖像插圖或一開始就為每個邊緣。

@屬性（非原子）UIEdgeInsets imageEdgeInsets如果每條邊的價值是積極的，指定的插圖，否則，指定一開始。一個插圖是周圍繪制矩形的保證金;每邊（左，右，頂部和底部），可以有不同的值。使用UIEdgeInsetsMake功能設置此屬性。默認值是UIEdgeInsetsZero。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 _AT_財產titleEdgeInsets

聲明在UIButton.h

[  編輯 ]

lineBreakMode

繪制文本時使用的換行模式。

屬性（非原子）UILineBreakMode lineBreakMode討論這個屬性是UILineBreakMode描述的常量之一。默認值是UILineBreakModeMiddleTruncation。

供貨情況在iPhone OS 2.0和更高版本。在UIButton.h聲明reversesTitleShadowWhenHighlighted一個布爾值，決定是否按鈕時，突出的標題陰影的變化。

如果有屬性（非原子）BOOL reversesTitleShadowWhenHighlighted討論，從雕刻的影子時，突出浮雕外觀的變化。默認值是NO。

供貨情況在iPhone OS 2.0和更高版本。聲明在UIButton.h

[  編輯 ]

showsTouchWhenHighlighted

一個布爾值，決定是否點擊按鈕會導致其發光。

@屬性（非原子）BOOL showsTouchWhenHighlighted討論，如果是的話，按鈕發光時挖掘出來，否則，它不會。圖像和按鈕的行為是沒有改變的輝光。默認值是NO。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 @財產adjustsImageWhenHighlighted

聲明在UIButton.h

[  編輯 ]

titleEdgeInsets

標題插圖或一開始就為每個邊緣。

@屬性（非原子）UIEdgeInsets titleEdgeInsets如果每條邊的價值是積極的，指定的插圖，否則，指定一開始。一個插圖是周圍繪制矩形的保證金;每邊（左，右，頂部和底部），可以有不同的值。使用UIEdgeInsetsMake功能設置此屬性。默認值是UIEdgeInsetsZero。

供貨情況在iPhone OS 2.0和更高版本。另請參見

 _AT_財產imageEdgeInsets

聲明在UIButton.h

[  編輯 ]

titleShadowOffset

用於顯示接收的標題陰影的偏移。

屬性（非原子）CGSize titleShadowOffset討論的水平和垂直偏移值，使用CGSize數據類型的寬度和高度場指定的。正面的價值觀總是向上延伸的權利，從用戶的角度來看。默認值是CGSizeZero。

供貨情況在iPhone OS 2.0和更高版本。宣布UIButton.h類方法

buttonWithType：創建並返回一個指定類型的新按鈕。

+（ID）buttonWithType：（UIButtonType）按鈕類型

[  編輯 ]

參數

[  編輯 ]

按鈕類型

按鈕類型。見的可能值UIButtonType。

返回值一個新創建的按鈕。

供貨情況在iPhone OS 2.0和更高版本。相關的示例代碼配件BubbleLevel TheElements TouchCells UICatalog宣布UIButton.h實例方法

[  編輯 ]

backgroundImageForState：

返回一個按鈕的狀態中使用的背景圖像。

- （UIImage的*）backgroundImageForState：（UIControlState）狀態

參數狀態的狀態使用的背景圖像。可能的值是在UIControlState描述。

返回值用於指定的狀態背景圖像。

供貨情況在iPhone OS 2.0和更高版本。又見 - setBackgroundImage：forState：UIButton.h聲明

[  編輯 ]

backgroundRectForBounds：

返回矩形的接收繪制其背景。

- （CGRect）backgroundRectForBounds：（CGRect）邊界

參數范圍接收器的邊界矩形。

返回值的矩形接收機，繪制其背景。

供貨情況在iPhone OS 2.0和更高版本。又見 - contentRectForBounds：UIButton.h聲明

[  編輯 ]

contentRectForBounds：

返回矩形的接收提請其全部內容。

- （CGRect）contentRectForBounds：（CGRect）邊界

參數限定為接收器的邊界矩形。

返回值的矩形接收提請其全部內容。

討論內容的矩形來顯示圖像和標題對齊和其他設置，包括任何填充和調整所需的面積。

供貨情況在iPhone OS 2.0和更高版本。 - titleRectForContentRect： - imageRectForContentRect： - backgroundRectForBounds：UIButton.h imageForState中聲明：返回一個按鈕的狀態所使用的圖像。

- （UIImage的*）imageForState：（UIControlState）狀態

參數狀態使用圖像的狀態。可能的值是在UIControlState描述。

返回值用於指定狀態的圖像。

供貨情況在iPhone OS 2.0和更高版本。又見 - setImage：forState：UIButton.h imageRectForContentRect宣布：返回接收繪制其圖像的矩形。

- （CGRect）imageRectForContentRect：（CGRect）contentRect

參數contentRect接收的內容矩形。

返回值接收繪制其圖像的矩形。

供貨情況在iPhone OS 2.0和更高版本。又見 - contentRectForBounds： - titleRectForContentRect：forState：：UIButton.h setBackgroundImage宣布設置背景圖像使用指定的按鈕狀態。

- （無效）setBackgroundImage：（UIImage的*）圖像forState：（UIControlState）狀態

參數圖像背景圖像使用指定的狀態。

狀態的狀態使用指定的圖像。在UIControlState值的描述。

在一般性討論，如果沒有一個國家指定一個屬性，默認是使用UIControlStateNormal的價值。如果UIControlStateNormal值未設置，則屬性默認為一個系統的價值。因此，至少，你應該設置為正常狀態的價值。

供貨情況在iPhone OS 2.0和更高版本。又見 - backgroundImageForState：相關示例代碼配件BubbleLevel TheElements UICatalog UIButton.h setImage宣布：forState：設置圖像使用指定的狀態。

- （無效）setImage：（UIImage的*）圖像forState：（UIControlState）狀態

參數圖像的圖像使用指定的狀態。

狀態的狀態使用指定的標題。在UIControlState值的描述。

在一般性討論，如果沒有一個國家指定一個屬性，默認是使用UIControlStateNormal的價值。如果UIControlStateNormal值未設置，則屬性默認為一個系統的價值。因此，至少，你應該設置為正常狀態的價值。

供貨情況在iPhone OS 2.0和更高版本。又見 - imageForState：forState：：相關示例代碼BubbleLevel在UIButton.h setTitle聲明TouchCells設置標題使用指定的狀態。

- （無效）setTitle是：（NSString的*）forState標題：（UIControlState）狀態

參數標題標題使用指定的狀態。

狀態的狀態使用指定的標題。在UIControlState值的描述。

在一般性討論，如果沒有一個國家指定一個屬性，默認是使用UIControlStateNormal的價值。如果UIControlStateNormal價值不設置，則屬性默認為系統值。因此，至少，你應該設置為正常狀態的價值。

供貨情況在iPhone OS 2.0和更高版本。又見 - titleForState：UIButton.h setTitleColor：forState相關的示例代碼BubbleLevel UICatalog宣布：設置標題使用指定的狀態的顏色。

- （無效）setTitleColor：（UIColor *）顏色forState：（UIControlState）狀態

參數顏色的標題使用指定的狀態的顏色。

狀態的狀態使用指定的顏色。在UIControlState值的描述。

在一般性討論，如果沒有一個國家指定一個屬性，默認是使用UIControlStateNormal的價值。如果UIControlStateNormal值未設置，則屬性默認為一個系統的價值。因此，至少，你應該設置為正常狀態的價值。

供貨情況在iPhone OS 2.0和更高版本。又見 - titleColorForState：UIButton.h setTitleShadowColor：forState相關的示例代碼BubbleLevel UICatalog宣布：設置標題陰影的顏色，使用指定的狀態。

- （無效）setTitleShadowColor：（UIColor *）顏色forState：（UIControlState）狀態

參數顏色的標題陰影的顏色，使用指定的狀態。

狀態的狀態使用指定的顏色。在UIControlState值的描述。

在一般性討論，如果沒有一個國家指定一個屬性，默認是使用UIControlStateNormal的價值。如果UIControlStateNormal值未設置，則屬性默認為一個系統的價值。因此，至少，你應該設置為正常狀態的價值。

供貨情況在iPhone OS 2.0和更高版本。又見 - titleShadowColorForState：UIButton.h titleColorForState宣布：返回一個國家使用的標題的顏色。

- （UIColor *）titleColorForState：（UIControlState）狀態

參數狀態的國家，使用的標題顏色。可能的值是在UIControlState描述。

返回值指定的狀態標題的顏色。

供貨情況在iPhone OS 2.0和更高版本。又見 - setTitleColor：forState：UIButton.h titleForState宣布：返回一個國家所使用的標題。

- （NSString的*）titleForState：（UIControlState）狀態

參數狀態的國家，使用的標題。可能的值是在UIControlState描述。

返回值指定的狀態標題。

供貨情況在iPhone OS 2.0和更高版本。又見 - setTitle：forState：UIButton.h titleRectForContentRect宣布：返回矩形的接收器繪制它的標題。

- （CGRect）titleRectForContentRect：（CGRect）contentRect

參數contentRect接收的內容矩形。

返回值的矩形接收器繪制它的標題。

供貨情況在iPhone OS 2.0和更高版本。又見 - contentRectForBounds： - imageRectForContentRect：UIButton.h titleShadowColorForState宣布：返回的陰影顏色為國家所用的標題。

- （UIColor *）titleShadowColorForState：（UIControlState）狀態

參數狀態的國家，使用的標題陰影顏色。可能的值是在UIControlState描述。

返回值指定的狀態標題的影子顏色。

供貨情況在iPhone OS 2.0和更高版本。又見 - setTitleShadowColor：forState：UIButton.h常量聲明

UIButtonType指定一個按鈕的風格。

的typedef枚舉{

  UIButtonTypeCustom = 0，UIButtonTypeRoundedRect，UIButtonTypeDetailDisclosure，UIButtonTypeInfoLight，UIButtonTypeInfoDark，UIButtonTypeContactAdd

} UIButtonType;常量UIButtonTypeCustom無按鈕的樣式。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

UIButtonTypeRoundedRect一個圓角矩形樣式的按鈕。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

UIButtonTypeDetailDisclosure一個詳細披露按鈕。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

UIButtonTypeInfoLight一個信息按鈕，有一個淺色背景。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

UIButtonTypeInfoDark一個信息按鈕，有一個黑暗的背景。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

UIButtonTypeContactAdd一個聯系人添加“按鈕。

在iPhone OS 2.0及更高版本。

聲明中UIButton.h。

供貨情況在iPhone OS 2.0和更高版本。聲明在UIButton.h