GCKUIButton 類別
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
支援自訂應用程式狀態的 UIButton 子類別。
這些狀態會以 OR 方式結合到按鈕的 state 屬性值，提供額外的應用程式專屬狀態。圖片可指派給這些自訂狀態，例如：
[按鈕 setImage:[UIImage imageNamed:@"myCustomStateImage"]
forState:(UIControlStateNormal | kMyControlStateCustom)];
應用程式狀態值只能使用在 UIControlStateApplication 位元遮罩中設定的位元。
- Deprecated:
- 使用 GCKUIMultistateButton。
- 開始時間
- 3.0
繼承 GCKUIMultistateButton。
| - (void) setImage: |
|
(UIImage *) |
image |
| forButtonState: |
|
(NSUInteger) |
buttonState |
|
|
| |
設定針對特定按鈕狀態要顯示的圖片。
- Parameters
-
| image | The image. |
| buttonState | The button state. |
| - (UIControlState) applicationState |
|
readwritenonatomicassign |
按鈕的應用程式狀態。
這個狀態會與按鈕的現有狀態進行 OR 運算。
| - (NSUInteger) buttonState |
|
readwritenonatomicassigninherited |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eGCKUIButton is a subclass of UIButton that supports custom application states, allowing developers to assign images to these states for enhanced UI customization.\u003c/p\u003e\n"],["\u003cp\u003eThis class is deprecated since version 3.0 and developers should use GCKUIMultistateButton instead.\u003c/p\u003e\n"],["\u003cp\u003eApplication state values should only use bits defined in the UIControlStateApplication bitmask to ensure compatibility and avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetImage:forButtonState:\u003c/code\u003e method allows setting images for specific button states, providing visual feedback to users.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eapplicationState\u003c/code\u003e property represents the button's current application state, which is ORed with the existing state to combine multiple states.\u003c/p\u003e\n"]]],["The GCKUIButton class, a subclass of UIButton, supports custom application states via the `state` property. Custom states are combined with the button's existing state. Images can be assigned to these custom states using `setImage:forButtonState:`. The `applicationState` property is ORed onto the button's state. The `buttonState` represents the button's state. Application states should use only bits within the `UIControlStateApplication` bitmask. The GCKUIButton is deprecated, and developers should use GCKUIMultistateButton instead.\n"],null,["# GCKUIButton Class\n\n[Instance Methods](#pub-methods) \\| [Properties](#properties) \nGCKUIButton Class Reference \n\nOverview\n--------\n\nA subclass of [**UIButton**](https://goo.gl/VK61wU) that supports custom application states.\n\nThese states are ORed onto the value of the button's **state** property to provide additional, application-specific states. Images can be assigned to these custom states, for example: \n\\[button setImage:\\[UIImage imageNamed:@\"myCustomStateImage\"\\] \nforState:(UIControlStateNormal \\| kMyControlStateCustom)\\];\n\nApplication state values must only use the bits that are set in the [**UIControlStateApplication**](https://goo.gl/tZWsqZ) bitmask.\n\n**[Deprecated:](/cast/docs/reference/ios/deprecated#_deprecated000040)**\n: Use [GCKUIMultistateButton](/cast/docs/reference/ios/interface_g_c_k_u_i_multistate_button \"A subclass of UIButton that supports multiple states. \").\n\n Since\n : 3.0\n\nInherits [GCKUIMultistateButton](/cast/docs/reference/ios/interface_g_c_k_u_i_multistate_button).\n\n|--------|--------------------------------------------------------------------------------------------------------------------------------|\n| Instance Method Summary ----------------------- ||\n| (void) | - [setImage:forButtonState:](/cast/docs/reference/ios/interface_g_c_k_u_i_multistate_button#afa6a9b60ccbe99ae3dd6fdd1f92225e3) |\n| | Sets the image to display for a given button state. [More...](#afa6a9b60ccbe99ae3dd6fdd1f92225e3) |\n| ||\n\n|----------------|-----------------------------------------------------------------------------------------------------------------|\n| Property Summary ---------------- ||\n| UIControlState | [applicationState](/cast/docs/reference/ios/interface_g_c_k_u_i_button#a1457e5e718738775b004a167c8591426) |\n| | The button's application state. [More...](#a1457e5e718738775b004a167c8591426) |\n| ||\n| NSUInteger | [buttonState](/cast/docs/reference/ios/interface_g_c_k_u_i_multistate_button#a51dc394e64d3837d6bffcad409f3f0f4) |\n| | The button's application state. [More...](#a51dc394e64d3837d6bffcad409f3f0f4) |\n| ||\n\nMethod Detail\n-------------\n\n|--------------------|---|--------------|---------------|\n| - (void) setImage: | | (UIImage \\*) | *image* |\n| forButtonState: | | (NSUInteger) | *buttonState* |\n| | | | |\n\nSets the image to display for a given button state.\n\nParameters\n:\n\n |-------------|-------------------|\n | image | The image. |\n | buttonState | The button state. |\n\n\nProperty Detail\n---------------\n\n|---------------------------------------------------------------------------------|--------------------------|\n| |-------------------------------------| | - (UIControlState) applicationState | | readwritenonatomicassign |\n\nThe button's application state.\n\nThis state is ORed onto the button's existing state. \n\n|---------------------------------------------------------------|-----------------------------------|\n| |----------------------------| | - (NSUInteger) buttonState | | readwritenonatomicassigninherited |\n\nThe button's application state."]]
