UIBarButtonItem 类

定义

命名空间:

UIKit

程序集:

Xamarin.iOS.dll

或 中托管的UIToolbarUINavigationBar按钮项。

[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)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。
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	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 UIBarItem)
AccessibilityAttributedLabel	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 UIBarItem)
AccessibilityAttributedValue	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 UIBarItem)
AccessibilityElementsHidden	获取或设置元素中包含的 thisIUIAccessibilityIdentification 辅助功能元素是否隐藏。 (继承自 UIBarItem)
AccessibilityFrame	获取或设置元素帧的 thisIUIAccessibilityIdentification 屏幕坐标。 (继承自 UIBarItem)
AccessibilityHint	获取或设置描述操作结果的本地化字符串。 (继承自 UIBarItem)
AccessibilityIdentifier	获取或设置标识元素的 thisIUIAccessibilityIdentification 标识符。 (继承自 UIBarItem)
AccessibilityLabel	获取或设置用于标识 thisIUIAccessibilityIdentification 元素的本地化字符串。 (继承自 UIBarItem)
AccessibilityLanguage	获取或设置 元素的 AccessibilityLabel、 AccessibilityValue和 AccessibilityHint 的语言 thisIUIAccessibilityIdentification 。 (继承自 UIBarItem)
AccessibilityNavigationStyle	获取或设置导航样式。 (继承自 UIBarItem)
AccessibilityPath	指定用于突出显示元素的元素路径的屏幕坐标。 (继承自 UIBarItem)
AccessibilityTraits	获取或设置最能描述元素特征的 thisIUIAccessibilityIdentification 辅助功能特征。 (继承自 UIBarItem)
AccessibilityValue	指定包含 元素值的 thisIUIAccessibilityIdentification 本地化字符串。 (继承自 UIBarItem)
AccessibilityViewIsModal	获取或设置 VoiceOver 是否忽略此图像对象的同级视图中的元素。 (继承自 UIBarItem)
Action	发送到指定为目标的 对象的操作。
Appearance	返回此类的 UIAppearance 类的强类型属性。
ButtonGroup	它UIBarButtonItem所属的 UIBarButtonItemGroup（如果有）。
Class	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ClassHandle	此类的句柄。
CustomView	用于表示 UIBarButtonItem 的自定义视图
DebugDescription	此对象的开发人员有意义的说明。 (继承自 NSObject)
Description	对象的说明，即 ToString 的 Objective-C 版本。 (继承自 NSObject)
Enabled	允许控制是启用或禁用 UIBarButtonItem。
Handle	处理指向非托管对象表示形式的 (指针) 。 (继承自 NSObject)
Image	按钮的图像。
ImageInsets	嵌入按钮图像。
IsAccessibilityElement	获取或设置此项是否是辅助应用可以访问的辅助功能对象。 (继承自 UIBarItem)
IsDirectBinding	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
IsProxy	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
LandscapeImagePhone	使用 iPhone 外观成语时，用于在横向中表示项目的图像。 (继承自 UIBarItem)
LandscapeImagePhoneInsets	使用 iPhone 外观成语时，横向的每个边缘 (或开始) 。 (继承自 UIBarItem)
LargeContentSizeImage	获取或设置 UIImage 要用于有视力障碍的用户的 。 (继承自 UIBarItem)
LargeContentSizeImageInsets	在显示 时获取或设置 UIEdgeInsets 。 (继承自 UIBarItem)
PossibleTitles	所有可能的游戏集 (用作系统大小调整) 的提示。
RetainCount	返回对象的当前 Objective-C 保留计数。 (继承自 NSObject)
Self	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ShouldGroupAccessibilityChildren	获取或设置 VoiceOver 是否对属于此对象的子元素进行分组，而不考虑其位置。 (继承自 UIBarItem)
SpringLoaded	获取或设置一个布尔值，该值控制对象是否参与弹簧加载的交互。
Style	用于按钮的系统样式。
Superclass	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
SuperHandle	用于表示此 NSObject 基类中方法的句柄。 (继承自 NSObject)
Tag	可用于缩进 UIBarButtonItem 的整数。
Target	将接收 Action 属性中指定的选择器的对象。
TintColor	要用于按钮的淡色。
Title	按钮中显示的标题
Width	按钮的宽度。
Zone	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 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 文件加载对象后调用。 替代器必须调用 base。AwakeFromNib () 。 (继承自 NSObject)
BeginInvokeOnMainThread(Action)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主 UI 线程上异步调用指定的代码。 (继承自 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
Bind(String, NSObject, String, NSDictionary)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
BindingInfo(String)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
BindingOptionDescriptions(String)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
BindingValueClass(String)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
CommitEditing()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ConformsToProtocol(IntPtr)	调用以确定此对象是否实现指定的协议。 (继承自 NSObject)
Copy()	执行基础 Objective-C 对象的副本。 (继承自 NSObject)
DangerousAutorelease()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
DangerousRelease()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
DangerousRetain()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指示对多关系的索引发生了更改。 (继承自 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
DidChangeValue(String)	指示对指定的键进行了更改。 (继承自 NSObject)
Dispose()	释放 NSObject 对象使用的资源。 (继承自 NSObject)
Dispose(Boolean)	释放 UIBarButtonItem 对象使用的资源。
DoesNotRecognizeSelector(Selector)	指示此对象无法识别指定的选择器。 (继承自 NSObject)
EncodeTo(NSCoder)	在提供的编码器上对对象的状态进行编码
Equals(NSObject)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
Equals(Object)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ExposedBindings()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetAppearance(UITraitCollection)	返回指定 traits的外观代理。
GetAppearance(UITraitCollection, Type[])	在包含层次结构中找到containers时，返回指定的 traits 的外观代理。
GetAppearance<T>()	获取 UIBarButtonItem 的子类的外观代理 UIBarButtonItem.UIBarButtonItemAppearance 。
GetAppearance<T>(UITraitCollection)	获取 UIBarButtonItem 的子类的外观代理 UIBarButtonItem.UIBarButtonItemAppearance 。
GetAppearance<T>(UITraitCollection, Type[])	当视图托管在指定的层次结构中时，获取具有指定特征集合的 UIBarButtonItem 子类的外观代理 UIBarButtonItem.UIBarButtonItemAppearance 。
GetBackButtonBackgroundImage(UIControlState, UIBarMetrics)	给定控件状态的后退按钮背景图像。 UINavigationBar仅用于后退按钮。
GetBackButtonBackgroundVerticalPositionAdjustment(UIBarMetrics)	后退按钮垂直位置偏移量。
GetBackButtonTitlePositionAdjustment(UIBarMetrics)	后退按钮标题偏移量。
GetBackgroundImage(UIControlState, UIBarButtonItemStyle, UIBarMetrics)	UIBarButtonItem 用作背景的 UIImage。
GetBackgroundImage(UIControlState, UIBarMetrics)	按钮的背景图像。
GetBackgroundVerticalPositionAdjustment(UIBarMetrics)	背景图像的垂直偏移量。
GetBindingInfo(NSString)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetBindingOptionDescriptions(NSString)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetBindingValueClass(NSString)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	检索指定键的值。 (继承自 NSObject)
GetHashCode()	为当前实例生成哈希代码。 (继承自 NSObject)
GetMethodForSelector(Selector)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetNativeField(String)	已过时. 或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetNativeHash()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
GetTitlePositionAdjustment(UIBarMetrics)	指定条形图指标的标题偏移量。
GetTitleTextAttributes(UIControlState)	UIBarItem 标题的文本属性。 (继承自 UIBarItem)
Init()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
InitializeHandle(IntPtr)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
InitializeHandle(IntPtr, String)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
Invoke(Action, Double)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
Invoke(Action, TimeSpan)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
InvokeOnMainThread(Action)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
InvokeOnMainThread(Selector, NSObject)	同步调用主 UI 线程上的指定代码。 (继承自 NSObject)
IsEqual(NSObject)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
IsKindOfClass(Class)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
IsMemberOfClass(Class)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
MarkDirty()	将常规对等对象 (IsDirectBinding 为 true) 提升为 toggleref 对象。 (继承自 NSObject)
MutableCopy()	创建指定 NSObject 的可变副本。 (继承自 NSObject)
ObjectDidEndEditing(NSObject)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	指示相对于此对象的指定 keyPath 处的值已更改。 (继承自 NSObject)
PerformSelector(Selector)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PerformSelector(Selector, NSObject)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double)	在当前实例上调用选择器，如果 obj 不为 null，则将其作为其单个参数传递。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PerformSelector(Selector, NSObject, NSObject)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
PrepareForInterfaceBuilder()	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 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)	或 中托管的UIToolbarUINavigationBar按钮项。
SetBackButtonTitlePositionAdjustment(UIOffset, UIBarMetrics)	允许为给定控件状态和条形指标指定后退按钮标题的偏移量。
SetBackgroundImage(UIImage, UIControlState, UIBarButtonItemStyle, UIBarMetrics)	指定用作背景的 UIImage。
SetBackgroundImage(UIImage, UIControlState, UIBarMetrics)	允许为给定控件状态和条形指标的按钮设置背景图像。
SetBackgroundVerticalPositionAdjustment(nfloat, UIBarMetrics)	或 中托管的UIToolbarUINavigationBar按钮项。
SetNativeField(String, NSObject)	已过时. 或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
SetNilValueForKey(NSString)	将指定键的值设置为 null。 (继承自 NSObject)
SetTitlePositionAdjustment(UIOffset, UIBarMetrics)	允许标题为指定条形指标的偏移量。
SetTitleTextAttributes(UITextAttributes, UIControlState)	指定 UIBarItem 标题的文本属性。 (继承自 UIBarItem)
SetValueForKey(NSObject, NSString)	将键指定的属性的值设置为指定的值。 (继承自 NSObject)
SetValueForKeyPath(IntPtr, NSString)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。 (继承自 NSObject)
SetValueForKeyPath(NSObject, NSString)	设置可以使用键路径访问的属性的值。 (继承自 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	指示尝试将值写入未定义的键。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	将此 NSObject 的值设置为指定字典中的值。 (继承自 NSObject)
ToString()	返回当前实例的值的字符串表示形式。 (继承自 NSObject)
Unbind(NSString)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
Unbind(String)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
ValueForKey(NSString)	返回与指定键关联的属性的值。 (继承自 NSObject)
ValueForKeyPath(NSString)	返回可以使用键路径访问的属性的值。 (继承自 NSObject)
ValueForUndefinedKey(NSString)	指示尝试读取未定义键的值。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指示指定键中指定索引的值即将更改。 (继承自 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	或 中托管的UIToolbarUINavigationBar按钮项。 (继承自 NSObject)
WillChangeValue(String)	指示指定键的值即将更改。 (继承自 NSObject)

事件

Clicked

当用户单击/点击此 UIBarButtonItem 时，将引发此事件。

扩展方法

GetDebugDescription(INSObjectProtocol)	或 中托管的UIToolbarUINavigationBar按钮项。
GetAccessibilityCustomRotors(NSObject)	获取适用于 this 对象的 对象的数组UIAccessibilityCustomRotor。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	设置适用于 this 对象的 对象数组UIAccessibilityCustomRotor。

另请参阅

• UIToolbar
• UINavigationBar
• Apple 文档 UIBarButtonItem