Added in API level 26
Deprecated in API level 31

Summary: Nested Classes | Methods | Inherited Methods

FontsContract

---

Kotlin |Java

public class FontsContract
extends Object

java.lang.Object
↳	android.provider.FontsContract

---

This class was deprecated in API level 31.
Use the Jetpack Core Library FontsContractCompat for consistent behavior across all devices.

Utility class to deal with Font ContentProviders.

Summary

Nested classes
class	FontsContract.Columns This class was deprecated in API level 31. Use the FontsContractCompat.Columns for consistent behavior across all devices.
class	FontsContract.FontFamilyResult This class was deprecated in API level 31. Use the FontsContractCompat.FontFamilyResult for consistent behavior across all devices
class	FontsContract.FontInfo This class was deprecated in API level 31. Use the FontsContractCompat.FontInfo for consistent behavior across all devices
class	FontsContract.FontRequestCallback This class was deprecated in API level 31. Use the FontsContractCompat.FontRequestCallback for consistent behavior across all devices

Public methods
static Typeface	buildTypeface(Context context, CancellationSignal cancellationSignal, FontInfo[] fonts) Build a Typeface from an array of FontInfo Results that are marked as not ready will be skipped.
static FontsContract.FontFamilyResult	fetchFonts(Context context, CancellationSignal cancellationSignal, FontRequest request) Fetch fonts given a font request.
static void	requestFonts(Context context, FontRequest request, Handler handler, CancellationSignal cancellationSignal, FontsContract.FontRequestCallback callback) Create a typeface object given a font request.

Inherited methods

From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

buildTypeface

Added in API level 26

public static Typeface buildTypeface (Context context, 
                CancellationSignal cancellationSignal, 
                FontInfo[] fonts)

Build a Typeface from an array of FontInfo Results that are marked as not ready will be skipped.

Parameters
context	Context: A Context that will be used to fetch the font contents. This value cannot be null.
cancellationSignal	CancellationSignal: A signal to cancel the operation in progress, or null if none. If the operation is canceled, then OperationCanceledException will be thrown.
fonts	FontInfo: An array of FontInfo to be used to create a Typeface. This value cannot be null.

Returns
Typeface	A Typeface object. Returns null if typeface creation fails.

fetchFonts

Added in API level 26

public static FontsContract.FontFamilyResult fetchFonts (Context context, 
                CancellationSignal cancellationSignal, 
                FontRequest request)

Fetch fonts given a font request.

Parameters
context	Context: A Context to be used for fetching fonts. This value cannot be null.
cancellationSignal	CancellationSignal: A signal to cancel the operation in progress, or null if none. If the operation is canceled, then OperationCanceledException will be thrown when the query is executed.
request	FontRequest: A FontRequest object that identifies the provider and query for the request. This value cannot be null.

Returns
FontsContract.FontFamilyResult	FontFamilyResult This value cannot be null.

Throws
PackageManager.NameNotFoundException	If requested package or authority was not found in system.

requestFonts

Added in API level 26

public static void requestFonts (Context context, 
                FontRequest request, 
                Handler handler, 
                CancellationSignal cancellationSignal, 
                FontsContract.FontRequestCallback callback)

Create a typeface object given a font request. The font will be asynchronously fetched, therefore the result is delivered to the given callback. See FontRequest. Only one of the methods in callback will be invoked, depending on whether the request succeeds or fails. These calls will happen on the caller thread. Note that the result Typeface may be cached internally and the same instance will be returned the next time you call this method with the same request. If you want to bypass this cache, use fetchFonts(Context, CancellationSignal, FontRequest) and buildTypeface(Context, CancellationSignal, FontInfo) instead.

Parameters
context	Context: A context to be used for fetching from font provider. This value cannot be null.
request	FontRequest: A FontRequest object that identifies the provider and query for the request. May not be null.
handler	Handler: A handler to be processed the font fetching. This value cannot be null.
cancellationSignal	CancellationSignal: A signal to cancel the operation in progress, or null if none. If the operation is canceled, then OperationCanceledException will be thrown.
callback	FontsContract.FontRequestCallback: A callback that will be triggered when results are obtained. May not be null.