UIFont 類別

定義

命名空間:: UIKit

組件:: Microsoft.iOS.dll

組件:: Microsoft.MacCatalyst.dll

組件:: Microsoft.tvOS.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

UIKit 類別的字型表示法。

[Foundation.Register("UIFont", true)]
public class UIFont : Foundation.NSObject, Foundation.INSCopying, Foundation.INSSecureCoding, IDisposable

[<Foundation.Register("UIFont", true)>]
type UIFont = class
    inherit NSObject
    interface INSCoding
    interface INativeObject
    interface IDisposable
    interface INSCopying
    interface INSSecureCoding

繼承: Object

NSObject
UIFont

屬性: RegisterAttribute

實作: INSCoding INSCopying INSSecureCoding INativeObject IDisposable

備註

UIFont 物件並非直接實例化，而是由此類別上的靜態方法建立。你可以使用 PreferredBody， PreferredCaption1， PreferredCaption2， PreferredHeadline，屬性 PreferredSubheadline 來取得對應使用情境的首選系統字型。

使用靜態 FromName(String, NFloat) 方法來建立特定字型的新字型。

你可以利用這個 FamilyNames 屬性取得所有可用字型名稱的清單，然後了解如何 FontNamesForFamilyName(String) 取得特定字型家族中可用字型的清單。

系統資訊與字型

若要取得代表系統字型的正常、斜體或粗體字型，請使用靜態方法 SystemFontOfSize(NFloat, UIFontWeight)、和 ItalicSystemFontOfSize(NFloat)BoldSystemFontOfSize(NFloat)。

啟動排版功能

你可以利用字型描述符，根據現有的字型實例取得新字型。要做到這點，你從字型取得不可變 FontDescriptor 屬性，並用它建立一個新的字型描述符，裡面有你想要的修改，然後你可以用這個描述符傳到 FromDescriptor(UIFontDescriptor, NFloat) 建立修改後字型的方法。

以下範例展示了如何修改現有字型，以啟用 CoreText 的比例數字排版功能，並使用字元替代：

UIFont CustomizeFont (UIFont font)
{
    var originalDescriptor = font.FontDescriptor;

    // This font has a character alternative, at index 1, use that:
    const int characterAlternative = 1;

    var attributes = new UIFontAttributes (
        new UIFontFeature (CTFontFeatureNumberSpacing.Selector.ProportionalNumbers),
        new UIFontFeature (characterAlternative));
    var newDesc = originalDescriptor.CreateWithAttributes (attributes);
    return UIFont.FromDescriptor (newDesc, 80);
}

字型的字元覆蓋範圍限制

以下範例透過修改字型描述符所支援的字元集，並強制系統使用系統中備用字型清單中的字形。例如，若使用 Menlo 字型，以下範例將移除 Melon Snowman 字元（在 Unicode 0x2603），並回歸系統雪人字元：

var label = new UILabel (new CGRect (0, 300, 200, 100)) {
    Text = "Hello \u2603 there!",
    TextColor = UIColor.White,
    Font = MyFonts.Menlo
};

var originalDescriptor = label.Font.FontDescriptor;
var originalCharSet = originalDescriptor.CharacterSet;

// Make a copy of the character set to modify
var charSetCopy = originalCharSet.MutableCopy () as NSMutableCharacterSet;

// Remove the snowman
charSetCopy.RemoveCharacters (new NSRange (0x2603, 1));

// Create new descriptor
var removedSnowmanDescriptor = originalDescriptor.CreateWithAttributes (new UIFontAttributes () {
    CharacterSet =  originalCharSet
});

// Create the font and set it on our label
label.Font = UIFont.FromDescriptor (removedSnowmanDescriptor, 0);

這個類別的成員可以從背景執行緒中使用。

建構函式

名稱	Description
UIFont(NativeHandle)	一種用於建立未受管理物件的受管理表示的建構器。由執行時呼叫。
UIFont(NSCoder)	一個建構器，能從未封存物件中儲存的資料初始化物件。
UIFont(NSObjectFlag)	用來呼叫衍生類別跳過初始化，僅僅配置物件。

屬性

名稱	Description
AccessibilityAttributedUserInputLabels	UIKit 類別的字型表示法。 (繼承來源 NSObject)
AccessibilityRespondsToUserInteraction	UIKit 類別的字型表示法。 (繼承來源 NSObject)
AccessibilityTextualContext	UIKit 類別的字型表示法。 (繼承來源 NSObject)
AccessibilityUserInputLabels	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Ascender	UIKit 類別的字型表示法。
ButtonFontSize	UIKit 類別的字型表示法。
CapHeight	UIKit 類別的字型表示法。
Class	UIKit 類別的字型表示法。 (繼承來源 NSObject)
ClassHandle	Objective-C 類別是這個類別的處理方式。
DebugDescription	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Descender	UIKit 類別的字型表示法。
Description	UIKit 類別的字型表示法。 (繼承來源 NSObject)
FamilyName	UIKit 類別的字型表示法。
FamilyNames	UIKit 類別的字型表示法。
FontDescriptor	UIKit 類別的字型表示法。
Handle	Handle（指標）指向未管理物件表示。 (繼承來源 NSObject)
IsDirectBinding	取得或設定一個值，指示此實例是否使用直接 Objective-C 綁定。 (繼承來源 NSObject)
IsProxy	UIKit 類別的字型表示法。 (繼承來源 NSObject)
LabelFontSize	UIKit 類別的字型表示法。
Leading	UIKit 類別的字型表示法。
LineHeight	UIKit 類別的字型表示法。
Name	UIKit 類別的字型表示法。
PointSize	UIKit 類別的字型表示法。
PreferredBody	正文格式的首選 UIFont 。
PreferredCallout	這是 Callout 文字風格的首選 UIFont 。
PreferredCaption1	這是 Caption1 文字風格的首選 UIFont 。
PreferredCaption2	首選 UIFont 的 Caption2 文字風格。
PreferredFootnote	這是腳註文字風格的首選 UIFont 。
PreferredHeadline	標題文字風格的首選 UIFont 。
PreferredSubheadline	副標題文字風格的首選 UIFont 。
PreferredTitle1	這是 Title1 文字風格的首選 UIFont 。
PreferredTitle2	這是 Title2 文字風格的首選 UIFont 。
PreferredTitle3	這是 Title3 文字風格的首選 UIFont 。
RetainCount	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Self	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SmallSystemFontSize	UIKit 類別的字型表示法。
Superclass	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SuperHandle	用 handle 表示此 NSObject基底類別中的方法。 (繼承來源 NSObject)
SystemFontSize	UIKit 類別的字型表示法。
xHeight	已淘汰. 小寫「x」的大小，以點數計。
XHeight	UIKit 類別的字型表示法。
Zone	UIKit 類別的字型表示法。 (繼承來源 NSObject)

方法

名稱	Description
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	以任意方法註冊物件以便外部觀察。 (繼承來源 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	以任意方法註冊物件以便外部觀察。 (繼承來源 NSObject)
AwakeFromNib()	UIKit 類別的字型表示法。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Action)	在主介面執行緒上非同步呼叫指定的動作。 (繼承來源 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	非同步地在主介面執行緒中呼叫指定的程式碼。 (繼承來源 NSObject)
BoldSystemFontOfSize(NFloat)	回傳指定大小的粗體系統字型。
ConformsToProtocol(NativeHandle)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Copy()	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Copy(NSZone)	執行底層 Objective-C 物件的複製。
DangerousAutorelease()	呼叫此物件的「自動釋放」選擇器。 (繼承來源 NSObject)
DangerousRelease()	呼叫此物件的「釋放」選擇器。 (繼承來源 NSObject)
DangerousRetain()	呼叫此物件的「保留」選擇器。 (繼承來源 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
DidChangeValue(String)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Dispose()	釋放物件 NSObject 所使用的資源。 (繼承來源 NSObject)
Dispose(Boolean)	釋放此物件所使用的資源。 (繼承來源 NSObject)
DoesNotRecognizeSelector(Selector)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
EncodeTo(NSCoder)	使用提供的編碼器編碼物件的狀態。
Equals(NSObject)	判斷指定的 NSObject 是否等於電流 NSObject。 (繼承來源 NSObject)
Equals(Object)	判斷指定的物件是否等於當前 UIFont的。
FontNamesForFamilyName(String)	UIKit 類別的字型表示法。
FromDescriptor(UIFontDescriptor, NFloat)	從指定的字型描述符建立 a UIFont 。
FromName(String, NFloat)	建立一個名稱和大小的字型。
GetDictionaryOfValuesFromKeys(NSString[])	UIKit 類別的字型表示法。 (繼承來源 NSObject)
GetHashCode()	為目前實例產生雜湊碼。
GetMethodForSelector(Selector)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
GetMonospacedSystemFont(NFloat, NFloat)	獲得指定大小與粗細的等寬系統字型。
GetMonospacedSystemFont(NFloat, UIFontWeight)	獲得指定大小與粗細的等寬系統字型。
GetNativeHash()	UIKit 類別的字型表示法。 (繼承來源 NSObject)
GetPreferredFontForTextStyle(NSString, UITraitCollection)	取得指定的文字風格和特質集合的首選字型。
GetPreferredFontForTextStyle(NSString)	會取得指定文字風格的首選字型。
GetPreferredFontForTextStyle(UIFontTextStyle, UITraitCollection)	得到 UIFont 系統偏好的 `uiFontTextStyletraitCollection`與。
GetPreferredFontForTextStyle(UIFontTextStyle)	會取得指定文字風格的首選字型。
Init()	透過呼叫 Objective-C `init` 方法初始化物件。 (繼承來源 NSObject)
InitializeHandle(NativeHandle, String)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
InitializeHandle(NativeHandle)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
Invoke(Action, Double)	在指定的延遲後執行指定動作。 (繼承來源 NSObject)
Invoke(Action, TimeSpan)	在指定的延遲後執行指定動作。 (繼承來源 NSObject)
InvokeOnMainThread(Action)	同步呼叫指定動作於主介面執行緒。 (繼承來源 NSObject)
InvokeOnMainThread(Selector, NSObject)	同步呼叫主介面執行緒中指定的程式碼。 (繼承來源 NSObject)
IsEqual(NSObject)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
IsKindOfClass(Class)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
IsMemberOfClass(Class)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
ItalicSystemFontOfSize(NFloat)	建立指定大小的斜體系統字型。
MarkDirty()	將一般的對等物件（IsDirectBinding 為真）升格為 toggleref 物件。 (繼承來源 NSObject)
MonospacedDigitSystemFontOfSize(NFloat, NFloat)	回傳系統專用的單寬字型，並以指定的大小與粗細呈現數字。
MonospacedDigitSystemFontOfSize(NFloat, UIFontWeight)	取得系統偏好顯示數字的等寬 UIFont ，且為指定 `fontSize` 和 `weight`。
MutableCopy()	UIKit 類別的字型表示法。 (繼承來源 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, Double)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject, NSObject)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSObject)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PerformSelector(Selector)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
PrepareForInterfaceBuilder()	UIKit 類別的字型表示法。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
RemoveObserver(NSObject, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
RemoveObserver(NSObject, String, IntPtr)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
RemoveObserver(NSObject, String)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
RespondsToSelector(Selector)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SetNilValueForKey(NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SetValueForKey(NSObject, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SetValueForKeyPath(NativeHandle, NSString)	將由給定金鑰路徑所識別的屬性值設定給定值。 (繼承來源 NSObject)
SetValueForKeyPath(NSObject, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
SystemFontOfSize(NFloat, NFloat)	回傳指定的 `size` 系統預設字型與 `weight`。
SystemFontOfSize(NFloat, UIFontWeight, UIFontWidth)	建立指定大小、粗細與寬度的系統字型。
SystemFontOfSize(NFloat, UIFontWeight)	取得指定 `size` 和 `weight`的系統字型。
SystemFontOfSize(NFloat)	建立指定大小的系統字型。
ToString()	回傳當前實例值的字串表示。
ValueForKey(NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
ValueForKeyPath(NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
ValueForUndefinedKey(NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
WillChangeValue(String)	UIKit 類別的字型表示法。 (繼承來源 NSObject)
WithSize(NFloat)	會回傳一個基於目前字型且大小相同的新字型。

運算子

名稱	Description
Equality(UIFont, UIFont)	比較兩個 UIFont 物件以求價值平等。
Inequality(UIFont, UIFont)	比較兩個 UIFont 物件以判斷價值不平等。

擴充方法

名稱	Description
AccessibilityHitTest(NSObject, CGPoint, UIEvent)	UIKit 類別的字型表示法。
BrowserAccessibilityDeleteTextAtCursor(NSObject, IntPtr)	UIKit 類別的字型表示法。
BrowserAccessibilityInsertTextAtCursor(NSObject, String)	UIKit 類別的字型表示法。
GetAccessibilityCustomRotors(NSObject)	取得適合物件`this`的UIAccessibilityCustomRotor物件陣列。
GetAccessibilityLineEndPositionFromCurrentSelection(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityLineRangeForPosition(NSObject, IntPtr)	UIKit 類別的字型表示法。
GetAccessibilityLineStartPositionFromCurrentSelection(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityNextTextNavigationElement(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityNextTextNavigationElementBlock(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityPreviousTextNavigationElement(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityPreviousTextNavigationElementBlock(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityTextInputResponder(NSObject)	UIKit 類別的字型表示法。
GetAccessibilityTextInputResponderHandler(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityAttributedValue(NSObject, NSRange)	UIKit 類別的字型表示法。
GetBrowserAccessibilityContainerType(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityCurrentStatus(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityHasDomFocus(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityIsRequired(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityPressedState(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityRoleDescription(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilitySelectedTextRange(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilitySortDirection(NSObject)	UIKit 類別的字型表示法。
GetBrowserAccessibilityValue(NSObject, NSRange)	UIKit 類別的字型表示法。
GetDebugDescription(INSObjectProtocol)	UIKit 類別的字型表示法。
GetHandle(INativeObject)	UIKit 類別的字型表示法。
GetNonNullHandle(INativeObject, String)	UIKit 類別的字型表示法。
ProvideImageData(NSObject, IntPtr, UIntPtr, UIntPtr, UIntPtr, UIntPtr, UIntPtr, NSObject)	UIKit 類別的字型表示法。
ProvideImageToMTLTexture(NSObject, IMTLTexture, IMTLCommandBuffer, UIntPtr, UIntPtr, UIntPtr, UIntPtr, NSObject)	UIKit 類別的字型表示法。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	設定適合物件`this`的UIAccessibilityCustomRotor物件陣列。
SetAccessibilityNextTextNavigationElement(NSObject, NSObject)	UIKit 類別的字型表示法。
SetAccessibilityNextTextNavigationElementBlock(NSObject, AXObjectReturnBlock)	UIKit 類別的字型表示法。
SetAccessibilityPreviousTextNavigationElement(NSObject, NSObject)	UIKit 類別的字型表示法。
SetAccessibilityPreviousTextNavigationElementBlock(NSObject, AXObjectReturnBlock)	UIKit 類別的字型表示法。
SetAccessibilityTextInputResponder(NSObject, IUITextInput)	UIKit 類別的字型表示法。
SetAccessibilityTextInputResponderHandler(NSObject, UITextInputReturnHandler)	UIKit 類別的字型表示法。
SetBrowserAccessibilityContainerType(NSObject, BEAccessibilityContainerType)	UIKit 類別的字型表示法。
SetBrowserAccessibilityCurrentStatus(NSObject, String)	UIKit 類別的字型表示法。
SetBrowserAccessibilityHasDomFocus(NSObject, Boolean)	UIKit 類別的字型表示法。
SetBrowserAccessibilityIsRequired(NSObject, Boolean)	UIKit 類別的字型表示法。
SetBrowserAccessibilityPressedState(NSObject, BEAccessibilityPressedState)	UIKit 類別的字型表示法。
SetBrowserAccessibilityRoleDescription(NSObject, String)	UIKit 類別的字型表示法。
SetBrowserAccessibilitySelectedTextRange(NSObject, NSRange)	UIKit 類別的字型表示法。
SetBrowserAccessibilitySortDirection(NSObject, String)	UIKit 類別的字型表示法。
SetSharedObservers(NSObject, NSKeyValueSharedObserversSnapshot)	UIKit 類別的字型表示法。

適用於

另請參閱

蘋果文件 UIFont