程序包 ohos.agp.text

类 FontFamily

java.lang.Object

ohos.agp.text.FontFamily

public class FontFamily
extends Object

Provides a set of fonts (RawFont) of different styles to create Font.

Ensure that the raw fonts added to a FontFamily belong to the same family, and they are only different in style (such as weight and italic).

从以下版本开始:

7

嵌套类概要

嵌套类

限定符和类型	类	说明
static class	FontFamily.Builder	Provides a builder to create a FontFamily instance.

方法概要

限定符和类型	方法	说明
FontFamily	createFamilyWithVariations(String variations)	Creates a FontFamily based on this FontFamily and the font variation settings.
RawFont	getRawFont(int index)	Obtains the RawFont object identified by the specified index in this FontFamily.
RawFont	getRawFont(int weight, boolean isItalic)	Obtains the RawFont of the specified style in this FontFamily.
int	getSize()	Obtains the number of RawFont objects in this FontFamily.
boolean	hasGlyph(int codePoint, int variationSelector)	Checks whether the FontFamily contains a glyph corresponding to the character specified by the Unicode.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getRawFont

public RawFont getRawFont(int index)

Obtains the RawFont object identified by the specified index in this FontFamily.

参数:

index - Indicates the index specified.

返回:

Returns the RawFont object if the operation is successful; returns null if the specified index is invalid.

getSize

public int getSize()

Obtains the number of RawFont objects in this FontFamily.

返回:

Returns the number of RawFont objects.

getRawFont

public RawFont getRawFont(int weight,
                          boolean isItalic)

Obtains the RawFont of the specified style in this FontFamily.

This method attempts to find a closest match, may not be the exact match.

参数:

weight - Indicates the font weight.

isItalic - Specifies whether the font is in italics. The value true means that the font is in italics, and false means the opposite.

返回:

Returns the RawFont object that most matches the specified conditions.

createFamilyWithVariations

public FontFamily createFamilyWithVariations(String variations)

Creates a FontFamily based on this FontFamily and the font variation settings.

参数:

variations - Indicates the font variation settings.

返回:

Returns the new FontFamily object created; returns null if this FontFamily does not support the font variation settings.

抛出:

NullPointerException - Throws this exception if the specified variations is null.

hasGlyph

public boolean hasGlyph(int codePoint,
                        int variationSelector)

Checks whether the FontFamily contains a glyph corresponding to the character specified by the Unicode.

参数:

codePoint - Indicates the Unicode value.

variationSelector - Indicates the variation selector of the font. For details, see: Variation Selectors

返回:

Returns true if the FontFamily contains a glyph corresponding to the character specified by the Unicode; returns false otherwise.