UIFontDescriptor 类

定义

命名空间:

UIKit

程序集:

Xamarin.iOS.dll

描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。

[Foundation.Register("UIFontDescriptor", true)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.iOS, 7, 0, ObjCRuntime.PlatformArchitecture.All, null)]
public class UIFontDescriptor : Foundation.NSObject, Foundation.INSCopying, Foundation.INSSecureCoding, IDisposable

type UIFontDescriptor = class
    inherit NSObject
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface INSCopying
    interface INSSecureCoding

继承

Object

NSObject

UIFontDescriptor

属性

RegisterAttribute IntroducedAttribute

实现

INSCoding INSCopying INSSecureCoding INativeObject IDisposable

注解

开发人员使用他们感兴趣的一组参数创建 UIFontDescriptors， (字体面、字体系列、字体属性、回退) 。 可以考虑这些描述符查询，稍后可以使用这些查询通过 方法创建具体的 UIFont FromDescriptor(UIFontDescriptor, nfloat) 。

这些对象是不可变的，一旦创建，就不能更改。 但在给定 UIFontDescriptor 的情况下，可以使用新信息创建更精确的字体描述符实例。 可以使用 方法创建具有更详细字体属性CreateWithAttributes(UIFontAttributes)的新 UIFontDescriptor，通过使用 和 CreateWithFamily(String) 方法显式设置字体或字体系列CreateWithFace(String)来扩展一个 UIFontDescriptor，使用 CreateWithSize(nfloat) 和 CreateWithMatrix(CGAffineTransform) 方法指定所需的字号或转换矩阵，或者请求使用 CreateWithTraits(UIFontDescriptorSymbolicTraits)提供某些样式特征。

此类公开各种静态属性，这些属性返回与用户的全局首选项匹配的 UIFontDescriptor (字号) 以及系统字体。 这些属性包括：PreferredHeadline、PreferredBody、PreferredSubheadline、 PreferredFootnotePreferredCaption1 和 PreferredCaption2。

可以使用 GetMatchingFontDescriptors(UIFontDescriptorAttribute[]) 方法获取一组与字体显式匹配的 UIFontDescriptors，也可以使用 CreateWithTraits(UIFontDescriptorSymbolicTraits) 和 FromDescriptor(UIFontDescriptor, nfloat) 方法隐式匹配。

以下示例演示如何创建两种字体：一种是正文文本的首选字体，一种是同一字体的粗体：

// Creates a UIFont for the body text
var bodyDescriptor = UIFontDescriptor.PreferredBody;
UIFont bodyFont = UIFont.FromDescriptor (bodyDescriptor, 0);

// Creates a bold version of it:
var boldDescriptor = bodyDescriptor.CreateWithTraits (UIFontDescriptorSymbolicTraits.Bold);
UIFont boldBodyFont = UIFont.FromDescriptor (boldDescriptor, 0);

此类的成员可以从后台线程使用。

构造函数

UIFontDescriptor()	默认构造函数初始化此类的新实例。
UIFontDescriptor(IntPtr)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。
UIFontDescriptor(NSCoder)	从 unarchiver 对象中存储的数据初始化 对象的构造函数。
UIFontDescriptor(NSDictionary)	使用字典中包含的一组属性创建 UIFontDescriptor。
UIFontDescriptor(NSObjectFlag)	用于调用派生类的构造函数，以跳过初始化并仅分配 对象。
UIFontDescriptor(UIFontAttributes)	使用指定的字体属性创建字体描述符。

属性

CascadeList	指定要在系统默认回退之前使用的子描述符列表。
CharacterSet	描述指定字体支持的字符集。
Class	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
ClassHandle	此类的句柄。
DebugDescription	此对象的开发人员有意义的说明。 (继承自 NSObject)
Description	对象的说明，即 ToString 的 Objective-C 版本。 (继承自 NSObject)
Face	字体。
Family	字体系列。
FeatureSettings	版式和布局功能设置。
FixedAdvance	对于单个字形，替代字体的固定前移。
FontAttributes	字体属性。
Handle	处理指向非托管对象表示形式的 (指针) 。 (继承自 NSObject)
IsDirectBinding	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
IsProxy	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Matrix	描述符的转换矩阵。
Name	描述符的名称。
PointSize	描述符中的点大小。
PostscriptName	字体的 PostScript 名称。
PreferredBody	获取描述 UIFontDescriptor 正文文本的首选字体的 。
PreferredCallout	获取 UIFontDescriptor 描述标注的首选字体的 。
PreferredCaption1	获取 UIFontDescriptor 描述标题的首选字体的 。
PreferredCaption2	获取 UIFontDescriptor 描述“caption 2”的首选字体的 。
PreferredFootnote	获取 UIFontDescriptor 描述脚注的首选字体的 。
PreferredHeadline	获取描述 UIFontDescriptor 标题的首选字体的 。
PreferredSubheadline	获取描述 UIFontDescriptor 副标题的首选字体的 。
PreferredTitle1	获取描述 UIFontDescriptor 标题的首选字体 ('标题 1') 。
PreferredTitle2	获取描述 UIFontDescriptor 级别 2 标题 (“标题 2”) 的首选字体的 。
PreferredTitle3	获取描述 UIFontDescriptor 级别 3 标题 (“标题 3”) 的首选字体的 。
RetainCount	返回对象的当前 Objective-C 保留计数。 (继承自 NSObject)
Self	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Size	如果设置) ，则 (字号。
Superclass	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
SuperHandle	用于表示此 NSObject 基类中方法的句柄。 (继承自 NSObject)
SymbolicTraits	字体的符号特征
TextStyle	要用于文本的样式的名称。
Traits	字体的特征。
VisibleName	此描述符的可见名称。
WeakFeatureSettings	功能设置的弱类型版本。
WeakFontAttributes	(弱) 字体属性。
Zone	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)

方法

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用 string keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AwakeFromNib()	从 nib 文件加载对象后调用。 重写程序必须调用 base。AwakeFromNib () 。 (继承自 NSObject)
BeginInvokeOnMainThread(Action)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主 UI 线程上异步调用指定的代码。 (继承自 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Bind(String, NSObject, String, NSDictionary)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
BindingInfo(String)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
BindingOptionDescriptions(String)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
BindingValueClass(String)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
CommitEditing()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
ConformsToProtocol(IntPtr)	调用 以确定此对象是否实现指定的协议。 (继承自 NSObject)
Copy()	执行基础 Objective-C 对象的副本。 (继承自 NSObject)
Copy(NSZone)	执行基础 Objective-C 对象的副本。
CreateWithAttributes(NSDictionary)	基于向当前描述符添加提供的属性创建新的 UIFontDescriptor。
CreateWithAttributes(UIFontAttributes)	基于向当前描述符添加提供的属性创建新的 UIFontDescriptor。
CreateWithFace(String)	基于将字体面设置为当前描述符创建新的 UIFontDescriptor。
CreateWithFamily(String)	基于将字体系列设置为当前描述符创建新的 UIFontDescriptor。
CreateWithMatrix(CGAffineTransform)	基于将新转换矩阵设置为当前描述符创建新的 UIFontDescriptor。
CreateWithSize(nfloat)	基于将新字号设置为当前描述符创建新的 UIFontDescriptor。
CreateWithTraits(UIFontDescriptorSymbolicTraits)	基于将新的符号特征设置为当前描述符创建新的 UIFontDescriptor。
DangerousAutorelease()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
DangerousRelease()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
DangerousRetain()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指示对多关系的索引发生了更改。 (继承自 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
DidChangeValue(String)	指示在指定的键上发生了更改。 (继承自 NSObject)
Dispose()	释放 NSObject 对象使用的资源。 (继承自 NSObject)
Dispose(Boolean)	释放 NSObject 对象使用的资源。 (继承自 NSObject)
DoesNotRecognizeSelector(Selector)	指示此对象无法识别指定的选择器。 (继承自 NSObject)
EncodeTo(NSCoder)	在提供的编码器上对对象的状态进行编码
Equals(NSObject)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Equals(Object)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
ExposedBindings()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
FromAttributes(NSDictionary)	(弱) 使用字典中包含的一组属性创建 UIFontDescriptor。
FromAttributes(UIFontAttributes)	使用字典中包含的一组属性创建 UIFontDescriptor。
FromName(String, CGAffineTransform)	使用指定的名称和转换矩阵创建 UIFontDescriptor。
FromName(String, nfloat)	使用指定的名称和字号创建 UIFontDescriptor。
GetBindingInfo(NSString)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetBindingOptionDescriptions(NSString)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetBindingValueClass(NSString)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	检索指定键的值。 (继承自 NSObject)
GetHashCode()	为当前实例生成哈希代码。 (继承自 NSObject)
GetMatchingFontDescriptors(NSSet)	检索具有一组显式功能的 UIFontDescriptor。
GetMatchingFontDescriptors(UIFontDescriptorAttribute[])	检索具有一组显式功能的 UIFontDescriptor。
GetMethodForSelector(Selector)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetNativeField(String)	已过时. 描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetNativeHash()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
GetObject(NSString)	用于从 UIFontDescriptor 检索属性的低级别/弱 API。
GetPreferredDescriptorForTextStyle(NSString)	用于检索用户所需字号的 API 的弱类型版本。
GetPreferredDescriptorForTextStyle(NSString, UITraitCollection)	返回指定样式和特征集合的首选字体描述符。
GetPreferredDescriptorForTextStyle(UIFontTextStyle)	用于检索用户所需字号的 API 的弱类型版本。
GetPreferredDescriptorForTextStyle(UIFontTextStyle, UITraitCollection)	返回指定样式和特征集合的首选字体描述符。
Init()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
InitializeHandle(IntPtr)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
InitializeHandle(IntPtr, String)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Invoke(Action, Double)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Invoke(Action, TimeSpan)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
InvokeOnMainThread(Action)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主 UI 线程上同步调用指定的代码。 (继承自 NSObject)
IsEqual(NSObject)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
IsKindOfClass(Class)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
IsMemberOfClass(Class)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
MarkDirty()	将常规对等对象 (IsDirectBinding 为 true) 提升为 toggleref 对象。 (继承自 NSObject)
MutableCopy()	创建指定 NSObject 的可变副本。 (继承自 NSObject)
ObjectDidEndEditing(NSObject)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	指示指定 keyPath 相对于此对象的值已更改。 (继承自 NSObject)
PerformSelector(Selector)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PerformSelector(Selector, NSObject)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double)	在当前实例上调用选择器，如果 obj 不为 null，则将其作为单个参数传递。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PerformSelector(Selector, NSObject, NSObject)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
PrepareForInterfaceBuilder()	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 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)
SetNativeField(String, NSObject)	已过时. 描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
SetNilValueForKey(NSString)	将指定键的值设置为 null。 (继承自 NSObject)
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)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
Unbind(String)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
ValueForKey(NSString)	返回与指定键关联的属性的值。 (继承自 NSObject)
ValueForKeyPath(NSString)	返回可使用键路径访问的属性的值。 (继承自 NSObject)
ValueForUndefinedKey(NSString)	指示尝试读取未定义键的值。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指示指定键中指定索引的值即将更改。 (继承自 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。 (继承自 NSObject)
WillChangeValue(String)	指示指定键的值即将更改。 (继承自 NSObject)

扩展方法

GetDebugDescription(INSObjectProtocol)	描述字体的属性，用于创建具有某些功能的字体。 提供查找与说明匹配的字体的方法。
GetAccessibilityCustomRotors(NSObject)	获取适用于 this 对象的 对象的数组UIAccessibilityCustomRotor。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	设置适用于 this 对象的 对象数组UIAccessibilityCustomRotor。

另请参阅

• Apple 文档 UIFontDescriptor