Typeface.CustomFallbackBuilder 類別

定義

命名空間:: Android.Graphics

組件:: Mono.Android.dll

重要

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

一個用於建立新 Typeface 實例的建構類別。

[Android.Runtime.Register("android/graphics/Typeface$CustomFallbackBuilder", ApiSince=29, DoNotGenerateAcw=true)]
public sealed class Typeface.CustomFallbackBuilder : Java.Lang.Object

[<Android.Runtime.Register("android/graphics/Typeface$CustomFallbackBuilder", ApiSince=29, DoNotGenerateAcw=true)>]
type Typeface.CustomFallbackBuilder = class
    inherit Object

繼承: Object

JavaObject

Object
Typeface.CustomFallbackBuilder

屬性: RegisterAttribute

備註

一個用於建立新 Typeface 實例的建構類別。

字型備退機制有兩種：自訂字型備援與系統字型備援。自訂字型備援是一個簡單的有序清單。文字渲染器會嘗試用第一個字型渲染字元，如果該字型不支援該字元，就嘗試下一個字元，依此類推。它會一直嘗試直到自訂備援鏈結束。自訂備用鏈的最大長度為 64。系統字型備援是系統預先定義的備援鏈。系統回備僅在自訂字型備援中找不到相符字型時才會處理。

範例，1）從單一 ttf 檔案建立字體。

<code>
            Font font = new Font.Builder("your_font_file.ttf").build();
            FontFamily family = new FontFamily.Builder(font).build();
            Typeface typeface = new Typeface.CustomFallbackBuilder(family).build();
</code>

2）從多個字型檔案建立字體，並預設選擇粗體樣式。

<code>
            Font regularFont = new Font.Builder("regular.ttf").build();
            Font boldFont = new Font.Builder("bold.ttf").build();
            FontFamily family = new FontFamily.Builder(regularFont)
                .addFont(boldFont).build();
            Typeface typeface = new Typeface.CustomFallbackBuilder(family)
                .setWeight(Font.FONT_WEIGHT_BOLD)  // Set bold style as the default style.
                                                   // If the font family doesn't have bold style font,
                                                   // system will select the closest font.
                .build();
</code>

3）從單一 ttf 檔案建立字體，若該字型沒有字形，則改用「襯線」字型家族。

<code>
            Font font = new Font.Builder("your_font_file.ttf").build();
            FontFamily family = new FontFamily.Builder(font).build();
            Typeface typeface = new Typeface.CustomFallbackBuilder(family)
                .setSystemFallback("serif")  // Set serif font family as the fallback.
                .build();
</code>

4）從單一 ttf 檔案建立字體，並設定另一個 ttf 檔案作為備援。

<code>
            Font font = new Font.Builder("English.ttf").build();
            FontFamily family = new FontFamily.Builder(font).build();

            Font fallbackFont = new Font.Builder("Arabic.ttf").build();
            FontFamily fallbackFamily = new FontFamily.Builder(fallbackFont).build();
            Typeface typeface = new Typeface.CustomFallbackBuilder(family)
                .addCustomFallback(fallbackFamily)  // Specify fallback family.
                .setSystemFallback("serif")  // Set serif font family as the fallback.
                .build();
</code>

</p>

Java 文件 android.graphics.Typeface.CustomFallbackBuilder。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Typeface.CustomFallbackBuilder(FontFamily)	建造一個帶有字體族的建築器。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
JniPeerMembers	一個用於建立新 Typeface 實例的建構類別。
MaxCustomFallbackCount	回傳自訂備用家族的最大容量。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
AddCustomFallback(FontFamily)	在自訂字型備援的末尾附加一個字型家族。
Build()	根據設定值建立字體。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
Equals(Object)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
SetStyle(FontStyle)	設定字型的字型樣式。
SetSystemFallback(String)	依名稱設定系統備援。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個用於建立新 Typeface 實例的建構類別。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個用於建立新 Typeface 實例的建構類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於