# FontFamily

Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Nested Classes](https://developer.android.com/reference/android/graphics/fonts/FontFamily#nestedclasses)\|[Methods](https://developer.android.com/reference/android/graphics/fonts/FontFamily#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/graphics/fonts/FontFamily#inhmethods)  

# FontFamily

*** ** * ** ***

[Kotlin](https://developer.android.com/reference/kotlin/android/graphics/fonts/FontFamily "View this page in Kotlin")\|Java

`
public

final

class
FontFamily
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


`

|---|-----------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | android.graphics.fonts.FontFamily |

<br />

*** ** * ** ***

A font family class can be used for creating Typeface.

A font family is a bundle of fonts for drawing text in various styles. For example, you can bundle regular style font and bold style font into a single font family, then system will select the correct style font from family for drawing.  

```
  FontFamily family = new FontFamily.Builder(new Font.Builder("regular.ttf").build())
      .addFont(new Font.Builder("bold.ttf").build()).build();
  Typeface typeface = new Typeface.Builder2(family).build();

  SpannableStringBuilder ssb = new SpannableStringBuilder("Hello, World.");
  ssb.setSpan(new StyleSpan(Typeface.Bold), 6, 12, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);

  textView.setTypeface(typeface);
  textView.setText(ssb);
 
```
In this example, "Hello, " is drawn with "regular.ttf", and "World." is drawn with "bold.ttf". If there is no font exactly matches with the text style, the system will select the closest font.

<br />

<br />

## Summary

|                                                                       ### Nested classes                                                                       ||
|----------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` class` | [FontFamily.Builder](https://developer.android.com/reference/android/graphics/fonts/FontFamily.Builder) A builder class for creating new FontFamily. |

|                                                                                                           ### Public methods                                                                                                           ||
|--------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[Font](https://developer.android.com/reference/android/graphics/fonts/Font) | ` `[getFont](https://developer.android.com/reference/android/graphics/fonts/FontFamily#getFont(int))`(int index) ` Returns a font                      |
| ` int`                                                                         | ` `[getSize](https://developer.android.com/reference/android/graphics/fonts/FontFamily#getSize())`() ` Returns the number of fonts in this FontFamily. |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(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](https://developer.android.com/reference/java/lang/Object#wait(long))`(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](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||

## Public methods

### getFont

Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public Font getFont (int index)
```

Returns a font

<br />

|                            Parameters                             ||
|---------|----------------------------------------------------------|
| `index` | `int`: an index of the font Value is 0 or greater <br /> |

|                                                              Returns                                                              ||
|-----------------------------------------------------------------------------|------------------------------------------------------|
| [Font](https://developer.android.com/reference/android/graphics/fonts/Font) | a registered font This value cannot be`null`. <br /> |

### getSize

Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public int getSize ()
```

Returns the number of fonts in this FontFamily.

<br />

|                                      Returns                                       ||
|-------|-----------------------------------------------------------------------------|
| `int` | the number of fonts registered in this family. Value is 1 or greater <br /> |