EastAsianFont Class

East Asian Font.When the object is serialized out as xml, its qualified name is a:ea.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Drawing.TextFontType
        DocumentFormat.OpenXml.Drawing.EastAsianFont

Namespace:  DocumentFormat.OpenXml.Drawing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
Public Class EastAsianFont _
    Inherits TextFontType
'Usage
Dim instance As EastAsianFont
public class EastAsianFont : TextFontType

Remarks

[ISO/IEC 29500-1 1st Edition]

21.1.2.3.3 ea (East Asian Font)

This element specifies that an East Asian font be used for a specific run of text. This font is specified with a typeface attribute much like the others but is specifically classified as an East Asian font.

[Example: Consider the DrawingML shown below.

<a:r>
<a:rPr …>
<a:ea typeface="Sample Font"/>
</a:rPr>
<a:t>Sample Text</a:t>
</a:r>

The above run of text is rendered using the East Asian font "Sample Font". end example]

If the specified font is not available on a system being used for rendering, then the attributes of this element can be utilized to select an alternative font.

Parent Elements

defRPr (§21.1.2.3.2); endParaRPr (§21.1.2.2.3); font (§20.1.4.2.13); majorFont (§20.1.4.1.24); minorFont (§20.1.4.1.25); rPr (§21.1.2.3.9)

Attributes

Description

charset (Similar Character Set)

Specifies the character set which is supported by the parent font. This information can be used in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.

The value of this attribute shall be interpreted as follows:

Value

Description

0x00

Specifies the ANSI character set. (IANA name iso-8859-1)

0x01

Specifies the default character set.

0x02

Specifies the Symbol character set. This value specifies that the characters in the Unicode private use area (U+FF00 to U+FFFF) of the font should be used to display characters in the range U+0000 to U+00FF.

0x4D

Specifies a Macintosh (Standard Roman) character set. (IANA name macintosh)

0x80

Specifies the JIS character set. (IANA name shift_jis)

0x81

Specifies the Hangul character set. (IANA name ks_c_5601-1987)

0x82

Specifies a Johab character set. (IANA name KS C-5601-1992)

0x86

Specifies the GB-2312 character set. (IANA name GBK)

0x88

Specifies the Chinese Big Five character set. (IANA name Big5)

0xA1

Specifies a Greek character set. (IANA name windows-1253)

0xA2

Specifies a Turkish character set. (IANA name iso-8859-9)

0xA3

Specifies a Vietnamese character set. (IANA name windows-1258)

0xB1

Specifies a Hebrew character set. (IANA name windows-1255)

0xB2

Specifies an Arabic character set. (IANA name windows-1256)

0xBA

Specifies a Baltic character set. (IANA name windows-1257)

0xCC

Specifies a Russian character set. (IANA name windows-1251)

0xDE

Specifies a Thai character set. (IANA name windows-874)

0xEE

Specifies an Eastern European character set. (IANA name windows-1250)

0xFF

Specifies an OEM character set not defined by ISO/IEC 29500.

Any other value

Application-defined, can be ignored.

The possible values for this attribute are defined by the W3C XML Schema byte datatype.

panose (Panose Setting)

Specifies the Panose-1 classification number for the current font using the mechanism defined in §4.2.7.17 of ISO/IEC 14496-22:2007.

The possible values for this attribute are defined by the ST_Panose simple type (§22.9.2.8).

pitchFamily (Similar Font Family)

Specifies the font pitch as well as the font family for the corresponding font. Because the value of this attribute is determined by a byte variable this value shall be interpreted as follows:

Value

Description

0x00

DEFAULT PITCH + UNKNOWN FONT FAMILY

0x01

FIXED PITCH + UNKNOWN FONT FAMILY

0x02

VARIABLE PITCH + UNKNOWN FONT FAMILY

0x10

DEFAULT PITCH + ROMAN FONT FAMILY

0x11

FIXED PITCH + ROMAN FONT FAMILY

0x12

VARIABLE PITCH + ROMAN FONT FAMILY

0x20

DEFAULT PITCH + SWISS FONT FAMILY

0x21

FIXED PITCH + SWISS FONT FAMILY

0x22

VARIABLE PITCH + SWISS FONT FAMILY

0x30

DEFAULT PITCH + MODERN FONT FAMILY

0x31

FIXED PITCH + MODERN FONT FAMILY

0x32

VARIABLE PITCH + MODERN FONT FAMILY

0x40

DEFAULT PITCH + SCRIPT FONT FAMILY

0x41

FIXED PITCH + SCRIPT FONT FAMILY

0x42

VARIABLE PITCH + SCRIPT FONT FAMILY

0x50

DEFAULT PITCH + DECORATIVE FONT FAMILY

0x51

FIXED PITCH + DECORATIVE FONT FAMILY

0x52

VARIABLE PITCH + DECORATIVE FONT FAMILY

This information is determined by querying the font when present and shall not be modified when the font is not available. This information can be used in font substitution logic to locate an appropriate substitute font when this font is not available.

The possible values for this attribute are defined by the W3C XML Schema byte datatype.

typeface (Text Typeface)

Specifies the typeface, or name of the font that is to be used. The typeface is a string name of the specific font that should be used in rendering the presentation. If this font is not available within the font list of the generating application than font substitution logic should be utilized in order to select an alternate font.

The possible values for this attribute are defined by the ST_TextTypeface simple type (§20.1.10.81).

[Note: The W3C XML Schema definition of this element’s content model (CT_TextFont) is located in §A.4.1. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

EastAsianFont Members

DocumentFormat.OpenXml.Drawing Namespace