UIBarButtonItem 類別

定義

命名空間:

UIKit

組件:

Xamarin.iOS.dll

裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。

[Foundation.Register("UIBarButtonItem", true)]
public class UIBarButtonItem : UIKit.UIBarItem, IDisposable, UIKit.IUISpringLoadedInteractionSupporting

type UIBarButtonItem = class
    inherit UIBarItem
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface IUISpringLoadedInteractionSupporting

繼承

Object

NSObject

UIBarItem

UIBarButtonItem

衍生

MapKit.MKUserTrackingBarButtonItem

屬性

RegisterAttribute

實作

INSCoding INativeObject IDisposable IUISpringLoadedInteractionSupporting

備註

UIBarButtonItems 是設計成放在 或 UINavigationBar 中 UIToolbar 的特殊按鈕。 它們會顯示標題或影像，並在按下時變更其外觀。 UIBarButtonItems 也可以設定為列舉中 UIBarButtonSystemItem 可用的一些系統提供的按鈕樣式。

在 iOS 11 中，物件的版面 UIBarButtonItem 配置策略已從自動調整大小變更為條件約束。 在物件中 UIBarButtonItem 內嵌其他元素 (例如內嵌 UIButton) 的開發人員應該明確設定條件約束，如下列範例所示：

var btn = new UIButton();
btn.TranslatesAutoresizingMaskIntoConstraints = false;
btn.WidthAnchor.ConstraintEqualTo(32.0f).Active = true;
btn.HeightAnchor.ConstraintEqualTo(32.0f).Active = true;

var barButtonItem = new UIBarButtonItem(btn);

建構函式

UIBarButtonItem()	預設建構函式，這個建構函式會初始化這個類別的新實例，不含任何參數。
UIBarButtonItem(IntPtr)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。
UIBarButtonItem(NSCoder)	從儲存在 unarchiver 物件中的資料初始化 物件的建構函式。
UIBarButtonItem(NSObjectFlag)	在衍生類別上呼叫的建構函式，以略過初始化，並只配置 物件。
UIBarButtonItem(String, UIBarButtonItemStyle, EventHandler)	建構函式，允許根據所使用的樣式，在按鈕上指定顯示標題。 也允許指定事件處理常式，以在按下按鈕時呼叫。
UIBarButtonItem(String, UIBarButtonItemStyle, NSObject, Selector)	允許指定 UIBarButtonItem 標題和樣式的建構函式，以及 Objective-C 樣式目標動作組。
UIBarButtonItem(UIBarButtonSystemItem)	建構函式，允許在建立按鈕時指定特定 UIBarButtonSystemItem 。
UIBarButtonItem(UIBarButtonSystemItem, EventHandler)	建構函式，允許在建立按鈕以及事件處理常式時指定特定 UIBarButtonSystemItem 。
UIBarButtonItem(UIBarButtonSystemItem, NSObject, Selector)	允許指定系統專案以及目標動作組的建構函式。
UIBarButtonItem(UIImage, UIBarButtonItemStyle, EventHandler)	建構函式，允許在建立按鈕時指定自訂影像、樣式和 evnet 處理常式。
UIBarButtonItem(UIImage, UIBarButtonItemStyle, NSObject, Selector)	允許指定影像和樣式的建構函式，以及目標動作組。
UIBarButtonItem(UIImage, UIImage, UIBarButtonItemStyle, NSObject, Selector)	允許為橫向和直向指定個別影像的建構函式。
UIBarButtonItem(UIView)	允許為 UIBarButtonItem 指定自訂檢視的建構函式。

屬性

AccessibilityActivationPoint	取得或設定專案啟動點 thisIUIAccessibilityIdentification 的螢幕座標。 (繼承來源 UIBarItem)
AccessibilityAttributedHint	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 UIBarItem)
AccessibilityAttributedLabel	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 UIBarItem)
AccessibilityAttributedValue	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 UIBarItem)
AccessibilityElementsHidden	取得或設定專案中包含的 thisIUIAccessibilityIdentification 協助工具專案是否隱藏。 (繼承來源 UIBarItem)
AccessibilityFrame	取得或設定元素框架的 thisIUIAccessibilityIdentification 螢幕座標。 (繼承來源 UIBarItem)
AccessibilityHint	取得或設定描述動作結果的當地語系化字串。 (繼承來源 UIBarItem)
AccessibilityIdentifier	取得或設定識別 thisIUIAccessibilityIdentification 專案的識別碼。 (繼承來源 UIBarItem)
AccessibilityLabel	取得或設定要識別 thisIUIAccessibilityIdentification 專案的當地語系化字串。 (繼承來源 UIBarItem)
AccessibilityLanguage	取得或設定 專案 、 AccessibilityValue 和 AccessibilityHintthisIUIAccessibilityIdentification 的語言。 AccessibilityLabel (繼承來源 UIBarItem)
AccessibilityNavigationStyle	取得或設定導覽樣式。 (繼承來源 UIBarItem)
AccessibilityPath	指定元素路徑的螢幕座標，該路徑是用來反白顯示專案。 (繼承來源 UIBarItem)
AccessibilityTraits	取得或設定最能描述 thisIUIAccessibilityIdentification 元素的協助工具特性。 (繼承來源 UIBarItem)
AccessibilityValue	指定包含 專案值的 thisIUIAccessibilityIdentification 當地語系化字串。 (繼承來源 UIBarItem)
AccessibilityViewIsModal	取得或設定 VoiceOver 是否忽略這個影像物件同層級檢視中的專案。 (繼承來源 UIBarItem)
Action	傳送至指定為目標物件的動作。
Appearance	傳回這個類別之 UIAppearance 類別的強型別屬性。
ButtonGroup	UIBarButtonItemGroup，如果有任何，則為這個 UIBarButtonItem 所屬的 。
Class	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ClassHandle	這個類別的控制碼。
CustomView	用來表示 UIBarButtonItem 的自訂檢視
DebugDescription	此物件的開發人員有意義描述。 (繼承來源 NSObject)
Description	物件的描述，ToString 的 Objective-C 版本。 (繼承來源 NSObject)
Enabled	允許控制 UIBarButtonItem 是否已啟用或停用。
Handle	處理 unmanaged 物件標記法) (指標。 (繼承來源 NSObject)
Image	按鈕的影像。
ImageInsets	將按鈕影像內嵌。
IsAccessibilityElement	取得或設定此專案是否為輔助應用程式可存取的協助工具物件。 (繼承來源 UIBarItem)
IsDirectBinding	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
IsProxy	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
LandscapeImagePhone	使用 iPhone 外觀慣用語時，用來表示橫向專案的影像。 (繼承來源 UIBarItem)
LandscapeImagePhoneInsets	使用 iPhone 外觀慣用語時，每個邊緣的內嵌 (或開始) 。 (繼承來源 UIBarItem)
LargeContentSizeImage	取得或設定 UIImage 要用於視覺受損使用者的 。 (繼承來源 UIBarItem)
LargeContentSizeImageInsets	取得或設定 UIEdgeInsets 顯示 時的 。 (繼承來源 UIBarItem)
PossibleTitles	所有可能標題的集合 (做為系統大小調整) 的提示。
RetainCount	傳回物件的目前 Objective-C 保留計數。 (繼承來源 NSObject)
Self	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ShouldGroupAccessibilityChildren	取得或設定 VoiceOver 是否將屬於這個物件的子系專案分組，而不論其位置為何。 (繼承來源 UIBarItem)
SpringLoaded	取得或設定 Boolean 值，控制物件是否參與 Spring 載入的互動。
Style	要用於按鈕的系統樣式。
Superclass	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
SuperHandle	用來表示這個 NSObject 基類中方法的控制碼。 (繼承來源 NSObject)
Tag	可用來縮排 UIBarButtonItem 的整數。
Target	物件，將接收 Action 屬性中指定的選取器。
TintColor	要用於按鈕的色調色彩。
Title	按鈕中顯示的標題
Width	按鈕的寬度。
Zone	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)

方法

AccessibilityActivate()	啟用此 UIView 的協助工具，並在 true 成功時傳回。 (繼承來源 UIBarItem)
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) ，註冊物件以供外部 (觀察。   觀察到的變更會分派至觀察者的 物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用字串 keyPath) ，註冊物件以供外部觀察 (。   觀察到的變更會分派至觀察者的 物件 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (繼承來源 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	註冊物件，以使用任意方法在外部觀察。 (繼承來源 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	註冊物件，以使用任意方法在外部觀察。 (繼承來源 NSObject)
AppearanceWhenContainedIn(Type[])	當檢視裝載于指定的階層時，傳回這個類別實例的強型別 UIAppearance。
AwakeFromNib()	從 nib 檔案載入物件之後呼叫。 覆寫程式必須呼叫基底。AwakeFromNib () 。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Action)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上以非同步方式叫用指定的程式碼。 (繼承來源 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
Bind(String, NSObject, String, NSDictionary)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
BindingInfo(String)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
BindingOptionDescriptions(String)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
BindingValueClass(String)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
CommitEditing()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ConformsToProtocol(IntPtr)	叫用以判斷這個物件是否實作指定的通訊協定。 (繼承來源 NSObject)
Copy()	執行基礎 Objective-C 物件的複本。 (繼承來源 NSObject)
DangerousAutorelease()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
DangerousRelease()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
DangerousRetain()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	表示對多關聯性的索引發生變更。 (繼承來源 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
DidChangeValue(String)	表示在指定的索引鍵上發生變更。 (繼承來源 NSObject)
Dispose()	釋放 NSObject 物件所使用的資源。 (繼承來源 NSObject)
Dispose(Boolean)	釋放 UIBarButtonItem 物件所使用的資源。
DoesNotRecognizeSelector(Selector)	表示這個物件無法辨識指定的選取器。 (繼承來源 NSObject)
EncodeTo(NSCoder)	編碼所提供編碼器上物件的狀態
Equals(NSObject)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
Equals(Object)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ExposedBindings()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetAppearance(UITraitCollection)	傳回指定 traits 的外觀 Proxy。
GetAppearance(UITraitCollection, Type[])	傳回在內含專案階層中找到 containers 時所指定 traits 的外觀 Proxy。
GetAppearance<T>()	取得 UIBarButtonItem 子類別的外觀 Proxy UIBarButtonItem.UIBarButtonItemAppearance 。
GetAppearance<T>(UITraitCollection)	取得 UIBarButtonItem 子類別的外觀 Proxy UIBarButtonItem.UIBarButtonItemAppearance 。
GetAppearance<T>(UITraitCollection, Type[])	取得 UIBarButtonItem 子類別的外觀 Proxy UIBarButtonItem.UIBarButtonItemAppearance ，當檢視裝載于指定的階層時，具有指定的特徵集合。
GetBackButtonBackgroundImage(UIControlState, UIBarMetrics)	指定控制項狀態的返回按鈕背景影像。 UINavigationBar僅用於返回按鈕。
GetBackButtonBackgroundVerticalPositionAdjustment(UIBarMetrics)	返回按鈕垂直位置位移。
GetBackButtonTitlePositionAdjustment(UIBarMetrics)	返回按鈕標題位移。
GetBackgroundImage(UIControlState, UIBarButtonItemStyle, UIBarMetrics)	UIBarButtonItem 用來作為背景的 UIImage。
GetBackgroundImage(UIControlState, UIBarMetrics)	按鈕的背景影像。
GetBackgroundVerticalPositionAdjustment(UIBarMetrics)	背景影像的垂直位移。
GetBindingInfo(NSString)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetBindingOptionDescriptions(NSString)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetBindingValueClass(NSString)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	擷取指定索引鍵的值。 (繼承來源 NSObject)
GetHashCode()	產生目前實例的雜湊碼。 (繼承來源 NSObject)
GetMethodForSelector(Selector)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetNativeField(String)	已淘汰. 裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetNativeHash()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
GetTitlePositionAdjustment(UIBarMetrics)	指定列計量的標題位移。
GetTitleTextAttributes(UIControlState)	UIBarItem 標題的文字屬性。 (繼承來源 UIBarItem)
Init()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
InitializeHandle(IntPtr)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
InitializeHandle(IntPtr, String)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
Invoke(Action, Double)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
Invoke(Action, TimeSpan)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
InvokeOnMainThread(Action)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主要 UI 執行緒上，以同步方式叫用指定的程式碼。 (繼承來源 NSObject)
IsEqual(NSObject)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
IsKindOfClass(Class)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
IsMemberOfClass(Class)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
MarkDirty()	將一般對等物件升階 (IsDirectBinding 為 true) 為 toggleref 物件。 (繼承來源 NSObject)
MutableCopy()	建立指定之 NSObject 的可變動複本。 (繼承來源 NSObject)
ObjectDidEndEditing(NSObject)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	表示相對於這個物件的指定 keyPath 值已變更。 (繼承來源 NSObject)
PerformSelector(Selector)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double)	在目前的實例上叫用選取器，如果 obj 不是 null，它會將這個 當做其單一參數傳遞。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, NSObject)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
PrepareForInterfaceBuilder()	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容之已變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String)	停止指定的觀察者接收指定 keyPath 變更值的進一步通知。 (繼承來源 NSObject)
RemoveObserver(NSObject, String, IntPtr)	停止指定的觀察者接收指定 keyPath 和內容之已變更值的進一步通知。 (繼承來源 NSObject)
RespondsToSelector(Selector)	這個物件是否可辨識指定的選取器。 (繼承來源 NSObject)
SetBackButtonBackgroundImage(UIImage, UIControlState, UIBarMetrics)	允許設定按鈕的背景影像。
SetBackButtonBackgroundVerticalPositionAdjustment(nfloat, UIBarMetrics)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。
SetBackButtonTitlePositionAdjustment(UIOffset, UIBarMetrics)	允許針對指定的控制項狀態和列計量指定返回按鈕標題的位移。
SetBackgroundImage(UIImage, UIControlState, UIBarButtonItemStyle, UIBarMetrics)	指定作為背景使用的 UIImage。
SetBackgroundImage(UIImage, UIControlState, UIBarMetrics)	允許針對指定控制項狀態和列計量的按鈕設定背景影像。
SetBackgroundVerticalPositionAdjustment(nfloat, UIBarMetrics)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。
SetNativeField(String, NSObject)	已淘汰. 裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
SetNilValueForKey(NSString)	將指定索引鍵的值設定為 null。 (繼承來源 NSObject)
SetTitlePositionAdjustment(UIOffset, UIBarMetrics)	允許指定長條圖度量的標題位移。
SetTitleTextAttributes(UITextAttributes, UIControlState)	指定 UIBarItem 標題的文字屬性。 (繼承來源 UIBarItem)
SetValueForKey(NSObject, NSString)	將索引鍵所指定的屬性值設定為指定的值。 (繼承來源 NSObject)
SetValueForKeyPath(IntPtr, NSString)	建立 Unmanaged 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。 (繼承來源 NSObject)
SetValueForKeyPath(NSObject, NSString)	設定可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	表示嘗試將值寫入未定義的索引鍵。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	將這個 NSObject 的值設定為指定字典中的值。 (繼承來源 NSObject)
ToString()	傳回目前實例值的字串表示。 (繼承來源 NSObject)
Unbind(NSString)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
Unbind(String)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
ValueForKey(NSString)	傳回與指定索引鍵相關聯的屬性值。 (繼承來源 NSObject)
ValueForKeyPath(NSString)	傳回可以使用索引鍵路徑到達的屬性值。 (繼承來源 NSObject)
ValueForUndefinedKey(NSString)	表示嘗試讀取未定義索引鍵的值。 如果未覆寫，則會引發 NSUndefinedKeyException。 (繼承來源 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	表示指定索引鍵中指定索引的值即將變更。 (繼承來源 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。 (繼承來源 NSObject)
WillChangeValue(String)	表示指定的索引鍵值即將變更。 (繼承來源 NSObject)

事件

Clicked

當使用者按一下/點選此 UIBarButtonItem 時，就會引發此事件。

擴充方法

GetDebugDescription(INSObjectProtocol)	裝載于 或 UINavigationBar 中的 UIToolbar 按鈕專案。
GetAccessibilityCustomRotors(NSObject)	取得適用于 this 物件的陣列 UIAccessibilityCustomRotor 。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	設定適用于 this 物件的陣列 UIAccessibilityCustomRotor 。

另請參閱

• UIToolbar
• UINavigationBar
• Apple 檔 UIBarButtonItem