DocumentID: ECMA-376/Part4/2.8.2
Title: ECMA-376, Part4: 2.8.2 Elements
Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006
Warning: Coverted to HTML format by a script known to have bugs

Navigation:

2.8.2 Elements

The following elements comprise the content of the font table:

2.8.2.1 altName (Alternate Names for Font)

This element specifies a set of alternative names which may be used to locate the font specified by the parent element. This set of alternative names is stored in a comma-delimited list, with all adjacent commas ignored (i.e. a value of Name A, Name B is equivalent to Name A,,,,,,,,, Name B).

When an application cannot locate a font using the primary name stored on the font attribute of the font element (§2.8.2.10), it should use each alternate name in term to attempt to locate the font, and use the first font for which is locates a match.

If this element is omitted, then no alternate names are present for the parent font.

[Example: Consider the following information stored for a single font:

<w:font w:name="SimSun">
  <w:altName w:val="Arial Unicode MS" />
  ...
</w:font>

The altName element specifies that when no font with a name of SimSun (the primary font name) can be located, that applications should attempt to locate a font with the name Arial Unicode MS before doing substitution based on the font metrics. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (String Value)

Specifies that its contents will contain a string.

The contents of this string are interpreted based on the context of the parent XML element.

[Example: Consider the following WordprocessingML fragment:

<w:pPr>

  <w:pStyle w:val="heading1" /> 

</w:pPr>

The value of the val attribute is the ID of the associated paragraph style's styleId.

However, consider the following fragment:

<w:sdtPr>

  <w:alias w:val="SDT Title Example" />

  ...

</w:sdtPr>

In this case, the decimal number in the val attribute is the caption of the parent structured document tag. In each case, the value is interpreted in the context of the parent element. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_String">

<attribute name="val" type="ST_String" use="required"/>

</complexType>

2.8.2.2 charset (Character Set Supported By Font)

This element specifies the character set which is supported by the parent font. This information may be used as defined 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 element shall be interpreted as follows:

Value

Description

0x00

Specifies the ANSI character set.

0x01

Specifies the default character set.

0x02

Specifies the Symbol character set.

0x4D

Specifies a Macintosh (Standard Roman) character set.

0x80

Specifies the JIS character set.

0x81

Specifies the Hangul character set.

0x82

Specifies a Johab character set.

0x86

Specifies the GB-2312 character set.

0x88

Specifies the Chinese Big Five character set.

0xA1

Specifies a Greek character set.

0xA2

Specifies a Turkish character set.

0xA3

Specifies a Vietnamese character set.

0xB1

Specifies a Hebrew character set.

0xB2

Specifies an Arabic character set.

0xBA

Specifies a Baltic character set.

0xCC

Specifies a Russian character set.

0xDE

Specifies a Thai character set.

0xEE

Specifies an Eastern European character set.

0xFF

Specifies an OEM character set not defined by this Office Open XML Standard.

Any other value

Application-defined, may be ignored.

If this element is not present, then the character set for this font shall be assumed to be the ANSI character set.

[Example: Consider the following information stored for a single font:

<w:font w:name="SimSun">
  <w:charset w:val="86" />
  ...
</w:font>

The charset element specifies via its val attribute value of 86 that this font uses the GB-2312 character set. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (Value)

Specifies a value specified as single octet (two digit) hexadecimal number whose contents are interpreted based on the context of the parent XML element.

[Example: Consider the following value for an attribute of type ST_UCharHexNumber:

<w:... w:val="BE"/>

This value is valid, as it contains two hexadecimal digits, an encoding of an octet of the actual decimal number value. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_UcharHexNumber">

<attribute name="val" type="ST_UcharHexNumber" use="required"/>

</complexType>

2.8.2.3 embedBold (Bold Style Font Style Embedding)

This element specifies information about the embedded font storage for the bold form of a font, when it is embedded. This form is used when bold is applied to a text run.

If this element is omitted, then no bold form of the font is stored in the document. The relationship targeted by the id attribute must be of the embedded font type, or the document shall be considered to be invalid.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedBold r:id="rId10" />
</w:font>

The embedBold element specifies that the embedded font targeted with the relationship with ID rId10 may be used to retrieve the bold form of the embedded Arial font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

fontKey (Embedded Font Obfuscation Key)

Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1.

If this attribute is omitted, then no key is provided for this font.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:fontKey="{302EE813-EB4A-4642-A93A-89EF99B2457E}" />
</w:font>

The fontKey attribute has a value of {302EE813-EB4A-4642-A93A-89EF99B2457E}, therefore the embedded Arial font targeted with the relationship with ID rId10 may be retrieved if needed by using this key and the algorithm above. end example]

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

id (Relationship to Part)

Namespace: .../officeDocument/2006/relationships

Specifies the relationship ID to a specified part.

The specified relationship shall match the type required by the parent element:

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer for the footerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/header for the headerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/font for the embedBold, embedBoldItalic, embedItalic, or embedRegular elements
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings for the printerSettings element

[Example: Consider an XML element which has the following id attribute:

<... r:id="rId10" />

The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]

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

subsetted (Embedded Font Is Subsetted)

Specifies that the embedded font targeted by the id attribute has been subsetted. Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.

If this attribute is omitted, then the embedded font target by the id attribute shall not be handled as though it is subsetted.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:subsetted="true" />
</w:font>

The subsetted attribute has a value of true, therefore the embedded Arial font targeted with the relationship with ID rId10 shall be treated as a subsetted font. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontRel">

<complexContent>

<extension base="CT_Rel">

<attribute name="fontKey" type="ST_Guid"/>

<attribute name="subsetted" type="ST_OnOff"/>

</extension>

</complexContent>

</complexType>

2.8.2.4 embedBoldItalic (Bold Italic Font Style Embedding)

This element specifies information about the embedded font storage for the bold italic form of a font, when it is embedded. This form is used when bold and italics are applied to a text run.

If this element is omitted, then no bold italic form of the font is stored in the document.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedBoldItalic r:id="rId11" />
</w:font>

The embedBoldItalic element specifies that the embedded font targeted with the relationship with ID rId11 may be used to retrieve the bold italic form of the embedded Arial font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

fontKey (Embedded Font Obfuscation Key)

Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1.

If this attribute is omitted, then no key is provided for this font.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:fontKey="{302EE813-EB4A-4642-A93A-89EF99B2457E}" />
</w:font>

The fontKey attribute has a value of {302EE813-EB4A-4642-A93A-89EF99B2457E}, therefore the embedded Arial font targeted with the relationship with ID rId10 may be retrieved if needed by using this key and the algorithm above. end example]

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

id (Relationship to Part)

Namespace: .../officeDocument/2006/relationships

Specifies the relationship ID to a specified part.

The specified relationship shall match the type required by the parent element:

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer for the footerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/header for the headerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/font for the embedBold, embedBoldItalic, embedItalic, or embedRegular elements
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings for the printerSettings element

[Example: Consider an XML element which has the following id attribute:

<... r:id="rId10" />

The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]

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

subsetted (Embedded Font Is Subsetted)

Specifies that the embedded font targeted by the id attribute has been subsetted. Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.

If this attribute is omitted, then the embedded font target by the id attribute shall not be handled as though it is subsetted.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:subsetted="true" />
</w:font>

The subsetted attribute has a value of true, therefore the embedded Arial font targeted with the relationship with ID rId10 shall be treated as a subsetted font. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontRel">

<complexContent>

<extension base="CT_Rel">

<attribute name="fontKey" type="ST_Guid"/>

<attribute name="subsetted" type="ST_OnOff"/>

</extension>

</complexContent>

</complexType>

2.8.2.5 embedItalic (Italic Font Style Embedding)

This element specifies information about the embedded font storage for the italic form of a font, when it is embedded. This form is used when italics are applied to a text run.

If this element is omitted, then no italic form of the font is stored in the document.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedItalic r:id="rId12" />
</w:font>

The embedItalic element specifies that the embedded font targeted with the relationship with ID rId12 may be used to retrieve the italic form of the embedded Arial font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

fontKey (Embedded Font Obfuscation Key)

Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1.

If this attribute is omitted, then no key is provided for this font.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:fontKey="{302EE813-EB4A-4642-A93A-89EF99B2457E}" />
</w:font>

The fontKey attribute has a value of {302EE813-EB4A-4642-A93A-89EF99B2457E}, therefore the embedded Arial font targeted with the relationship with ID rId10 may be retrieved if needed by using this key and the algorithm above. end example]

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

id (Relationship to Part)

Namespace: .../officeDocument/2006/relationships

Specifies the relationship ID to a specified part.

The specified relationship shall match the type required by the parent element:

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer for the footerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/header for the headerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/font for the embedBold, embedBoldItalic, embedItalic, or embedRegular elements
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings for the printerSettings element

[Example: Consider an XML element which has the following id attribute:

<... r:id="rId10" />

The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]

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

subsetted (Embedded Font Is Subsetted)

Specifies that the embedded font targeted by the id attribute has been subsetted. Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.

If this attribute is omitted, then the embedded font target by the id attribute shall not be handled as though it is subsetted.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:subsetted="true" />
</w:font>

The subsetted attribute has a value of true, therefore the embedded Arial font targeted with the relationship with ID rId10 shall be treated as a subsetted font. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontRel">

<complexContent>

<extension base="CT_Rel">

<attribute name="fontKey" type="ST_Guid"/>

<attribute name="subsetted" type="ST_OnOff"/>

</extension>

</complexContent>

</complexType>

2.8.2.6 embedRegular (Regular Font Style Embedding)

This element specifies information about the embedded font storage for the regular form of a font, when it is embedded. This form is used when neither bold nor italics is applied to a text run.

If this element is omitted, then no regular form of the font is stored in the document.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId13" />
</w:font>

The embedRegular element specifies that the embedded font targeted with the relationship with ID rId13 may be used to retrieve the regular form of the embedded Arial font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

fontKey (Embedded Font Obfuscation Key)

Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1.

If this attribute is omitted, then no key is provided for this font.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:fontKey="{302EE813-EB4A-4642-A93A-89EF99B2457E}" />
</w:font>

The fontKey attribute has a value of {302EE813-EB4A-4642-A93A-89EF99B2457E}, therefore the embedded Arial font targeted with the relationship with ID rId10 may be retrieved if needed by using this key and the algorithm above. end example]

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

id (Relationship to Part)

Namespace: .../officeDocument/2006/relationships

Specifies the relationship ID to a specified part.

The specified relationship shall match the type required by the parent element:

  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer for the footerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/header for the headerReference element
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/font for the embedBold, embedBoldItalic, embedItalic, or embedRegular elements
  • http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings for the printerSettings element

[Example: Consider an XML element which has the following id attribute:

<... r:id="rId10" />

The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]

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

subsetted (Embedded Font Is Subsetted)

Specifies that the embedded font targeted by the id attribute has been subsetted. Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.

If this attribute is omitted, then the embedded font target by the id attribute shall not be handled as though it is subsetted.

[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:

<w:font w:name="Arial">
  ...
  <w:embedRegular r:id="rId10" w:subsetted="true" />
</w:font>

The subsetted attribute has a value of true, therefore the embedded Arial font targeted with the relationship with ID rId10 shall be treated as a subsetted font. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontRel">

<complexContent>

<extension base="CT_Rel">

<attribute name="fontKey" type="ST_Guid"/>

<attribute name="subsetted" type="ST_OnOff"/>

</extension>

</complexContent>

</complexType>

2.8.2.7 embedSystemFonts (Embed Common System Fonts)

This element specifies that applications shall embed common system fonts when they are in use and font embedding is enabled for this document using the embedTrueTypeFonts element (§2.8.2.8). Common system fonts refer to a set of fonts which are typically always present on a machine, and are not defined by this Office Open XML Standard.

If this element is omitted, then the set of fonts defined as common system fonts should not be embedded in the current document when font embedded is turned on. If the embedTrueTypeFonts element is omitted or false, then this setting has no effect.

[Example: Consider a WordprocessingML document that specifies that it shall embed fonts, including common system fonts. This requirement would be specified using the following WordprocessingML in the document settings part:

<w:embedTrueTypeFonts w:val="true" />
<w:embedSystemFonts w:val="true"/>

The embedSystemFonts element's val attribute has a value of true specifying that common system fonts should be included in this document when they are used. end example]

Parent Elements

settings (§2.15.1.78)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:... w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_OnOff">

<attribute name="val" type="ST_OnOff"/>

</complexType>

2.8.2.8 embedTrueTypeFonts (Embed TrueType Fonts)

This element specifies that applications shall embed the fonts in use in this document when it is saved. These fonts shall be embedded subject to the algorithm specified in §2.8.1.

If this element is omitted, then fonts in use should not be embedded in the current document.

[Example: Consider a WordprocessingML document that specifies that it shall embed fonts, including common system fonts. This requirement would be specified using the following WordprocessingML in the document settings part:

<w:embedTrueTypeFonts w:val="true" />
<w:embedSystemFonts w:val="true"/>

The embedTrueType element's val attribute has a value of true specifying that fonts should be embedded in this document when they are used. end example]

Parent Elements

settings (§2.15.1.78)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:... w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_OnOff">

<attribute name="val" type="ST_OnOff"/>

</complexType>

2.8.2.9 family (Font Family)

This element specifies the font family of the current font. This information may be used as defined 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.

If this element is omitted, then its value shall be assumed to be auto.

[Example: Consider the following information stored for a single font:

<w:font w:name="Calibri">
  <w:family w:val="swiss" />
  ...
</w:font>

The family element specifies via its val attribute value of swiss that this font is part of the Swiss family. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (Font Family Value)

Specifies the font family for the parent font.

[Example: Consider the following information stored for a single font:

<w:font w:name="Times New Roman">
  <w:family w:val="roman" />
  ...
</w:font>

The val attribute value of swiss that this font is part of the Roman family. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontFamily">

<attribute name="val" type="ST_FontFamily" use="required"/>

</complexType>

2.8.2.10 font (Properties for a Single Font)

This element specifies the properties for one of the fonts used in this document. A font element shall be written out for each font face used in the document, and includes:

[Example: Consider the following information stored for a single font:

<w:font w:name="Times New Roman">
  <w:panose1 w:val="02020603050405020304" />
  <w:charset w:val="00" />
  <w:family w:val="roman" />
  <w:pitch w:val="variable" />
  <w:sig w:usb0="20002A87" w:usb1="80000000" w:usb2="00000008" w:usb3="00000000" w:csb0="000001FF" w:csb1="00000000" />
</w:font>

The font element contains information about the Times New Roman font; specifically, information used to locate a substitute font if it is not available. end example]

Parent Elements

fonts (§2.8.2.11)

Child Elements

Subclause

altName (Alternate Names for Font)

§2.8.2.1

charset (Character Set Supported By Font)

§2.8.2.2

embedBold (Bold Style Font Style Embedding)

§2.8.2.3

embedBoldItalic (Bold Italic Font Style Embedding)

§2.8.2.4

embedItalic (Italic Font Style Embedding)

§2.8.2.5

embedRegular (Regular Font Style Embedding)

§2.8.2.6

family (Font Family)

§2.8.2.9

notTrueType (Raster or Vector Font)

§2.8.2.12

panose1 (Pansose-1 Typeface Classification Number)

§2.8.2.13

pitch (Font Pitch)

§2.8.2.14

sig (Supported Unicode Subranges and Code Pages)

§2.8.2.16

Attributes

Description

name (Primary Font Name)

Specifies the primary name of the current font. This name shall be used to link the information stored in this element with uses of this value in the rFonts element (§2.3.2.24) in document content.

[Example: Consider the following information stored for a single font:

<w:font w:name="Times New Roman">
  ...
</w:font>

The name attribute specifies that the information contained in this element shall be used to look up information about all uses of the Times New Roman font in the document contents. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Font">

<sequence>

<element name="altName" type="CT_String" minOccurs="0" maxOccurs="1"/>

<element name="panose1" type="CT_Panose" minOccurs="0" maxOccurs="1"/>

<element name="charset" type="CT_UcharHexNumber" minOccurs="0" maxOccurs="1"/>

<element name="family" type="CT_FontFamily" minOccurs="0" maxOccurs="1"/>

<element name="notTrueType" type="CT_OnOff" minOccurs="0" maxOccurs="1"/>

<element name="pitch" type="CT_Pitch" minOccurs="0" maxOccurs="1"/>

<element name="sig" type="CT_FontSig" minOccurs="0" maxOccurs="1"/>

<element name="embedRegular" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>

<element name="embedBold" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>

<element name="embedItalic" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>

<element name="embedBoldItalic" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>

</sequence>

<attribute name="name" type="ST_String" use="required"/>

</complexType>

2.8.2.11 fonts (Font Table Root Element)

This element specifies the root element for a font table part within a WordprocessingML document, and specifies information about the fonts used in this document, each contained within a child font element.

[Example: Consider the following information stored in a font table part:

<w:fonts>
  <w:font w:name="Times New Roman">
    ...
  </w:font>
  <w:font w:name="Arial">
    ...
  </w:font>
</w:fonts>

The fonts element contains information about all fonts used in the document - in this example, the Times New Roman and Arial fonts. end example]

Parent Elements

Root element of WordprocessingML Font Table part

Child Elements

Subclause

font (Properties for a Single Font)

§2.8.2.10

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontsList">

<sequence>

<element name="font" type="CT_Font" minOccurs="0" maxOccurs="unbounded"/>

</sequence>

</complexType>

2.8.2.12 notTrueType (Raster or Vector Font)

This element specifies that this font is not a TrueType or OpenType font, but is rather a raster or vector font. This information may be used as defined 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.

If this element is omitted, then the font shall be assumed to be a TrueType or OpenType font.

[Example: Consider the following information stored for a single font:

<w:font w:name="JonsFont">
  <w:notTrueType w:val="true" />
  ...
</w:font>

The notTrueType element specifies via its val attribute value of true that this font is a raster or vector font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:... w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_OnOff">

<attribute name="val" type="ST_OnOff"/>

</complexType>

2.8.2.13 panose1 (Pansose-1 Typeface Classification Number)

This element specifies the Panose-1 classification number for the current font using the PANOSE Classification Guide, Version 1.2. This information may be used as defined 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.

If this element is omitted, then no Panose-1 information is available.

[Example: Consider the following information stored for a single font:

<w:font w:name="Times New Roman">
  <w:panose1 w:val="02020603050405020304" />
  ...
</w:font>

The panose1 element specifies its Panose-1 number via its val attribute value of 02020603050405020304. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (Value)

Specifies the Panose-1 classification number for the font, stored as a series of two digit hexadecimal encodings of each digits of the Panose number.

[Example: Consider the following information stored for a single font:

<w:panose1 w:val="020F0603050405020304" />

The val attribute specifies that the digits in the Panose-1 number are: 2,15,6,3,5,2,3,4. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Panose">

<attribute name="val" type="ST_Panose" use="required"/>

</complexType>

2.8.2.14 pitch (Font Pitch)

This element specifies the font pitch of the current font. This information may be used as defined 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.

If this element is omitted, then its value shall be assumed to be default.

[Example: Consider the following information stored for a single font:

<w:font w:name="Courier New">
  <w:pitch w:val="fixed" />
  ...
</w:font>

The pitch element specifies via its val attribute value of fixed that this is a fixed width font. end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

val (Value)

Specifies the font pitch for the font.

[Example: Consider the following information stored for a single font:

<w:pitch w:val="variable" />

The val attribute value of variable specifies that this is a variable width font. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Pitch">

<attribute name="val" type="ST_Pitch" use="required"/>

</complexType>

2.8.2.15 saveSubsetFonts (Subset Fonts When Embedding)

This element specifies that applications shall subset fonts when font embedding is enabled for this document using the embedTrueTypeFonts element (§2.8.2.8). Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.

If this element is omitted, then the set of fonts should not be subsetted in the current document when font embedded is turned on. If the embedTrueTypeFonts element is omitted or false, then this setting has no effect.

[Example: Consider a WordprocessingML document that specifies that it shall subset embedded fonts. This requirement would be specified using the following WordprocessingML in the document settings part:

<w:embedTrueTypeFonts w:val="true" />
<w:saveSubsetFonts w:val="true"/>

The embedSystemFonts element's val attribute has a value of true specifying fonts should be subsetted in this document when they are embedded. end example]

Parent Elements

settings (§2.15.1.78)

Attributes

Description

val (On/Off Value)

Specifies a binary value for the property defined by the parent XML element.

A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted.

A value of off, 0, or false specifies that the property shall be explicitly turned off.

[Example: For example, consider the following on/off property:

<w:... w:val="off"/>

The val attribute explicitly declares that the property is turned off. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_OnOff">

<attribute name="val" type="ST_OnOff"/>

</complexType>

2.8.2.16 sig (Supported Unicode Subranges and Code Pages)

This element specifies information identifying the code pages and Unicode subranges for which the parent font provides glyphs. This information may be used as defined 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.

When storing Unicode subrange information, the appropriate bit in the bitfield shall only be set if the entire subrange is supported by that font.

If this element is omitted, then no supported code page/Unicode subrange information is available.

[Example: Consider the following information stored for a single font:

<w:font w:name="Times New Roman">
  <w:sig w:usb0="20002A87" w:usb1="80000000" w:usb2="00000008" w:usb3="00000000" w:csb0="000001FF" w:csb1="00000000" />
  ...
</w:font>

The sig element specifies the supported code pages and Unicode sub ranges via its attributes. For example, the code pages supported are:

end example]

Parent Elements

font (§2.8.2.10)

Attributes

Description

csb0 (Lower 32 Bits of Code Page Bit Field)

Specifies a four digit hexadecimal encoding of the first 32 bits of the 64-bit code-page bit field that identifies which specific character sets or code pages are supported by the parent font.

Each bit in this 32 bits represents the following code page:

Bit

Description

0

Latin 1

1

Latin 2: Eastern Europe

2

Cyrillic

3

Greek

4

Turkish

5

Hebrew

6

Arabic

7

Windows Baltic

8 to 16

Reserved for Alternate ANSI

17

Thai

18

JIS/Japan

19

Chinese (Simplified)

20

Korean Wansung

21

Chinese (Traditional)

22 to 29

Reserved for Alternate ANSI and OEM

30

Macintosh Character Set (Standard Roman)

31

Symbol Character Set

[Example: Consider font information specified as follows:

<w:font w:name="Lucida Console">
  <w:sig w:csb0="0000001F" ... />
  ...
</w:font>

The csb0 attribute value of 0000001F specifies that the following code pages are supported by this font:

  • Latin 1
  • Latin 2: Eastern Europe
  • Cyrillic
  • Greek
  • Turkish

end example]

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

csb1 (Upper 32 Bits of Code Page Bit Field)

Specifies a four digit hexadecimal encoding of the upper 32 bits of the 64-bit code-page bit field that identifies which specific character sets or code pages are supported by the parent font.

Each bit in this 32 bits represents the following code page:

Bit

Description

0 to 15

Reserved for OEM

16

IBM Greek

17

MS-DOS Russian

18

MS-DOS Nordic

19

Arabic

20

MS-DOS Canadian French

21

Hebrew

22

MS-DOS Icelandic

23

MS-DOS Portuguese

24

IBM Turkish

25

IBM Cyrillic

26

Latin 2

27

MS-DOS Baltic

28

Greek (former 437G)

29

Arabic (AMSO 708)

30

WE/Latin 1

31

US

[Example: Consider font information specified as follows:

<w:font w:name="Lucida Console">
  <w:sig w:csb1="00000000" ... />
  ...
</w:font>

The csb1 attribute value of 00000000 specifies that none of the specified code pages are supported by this font. end example]

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

usb0 (First 32 Bits of Unicode Subset Bitfield)

Specifies the first 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard.

[Example: Consider font information specified as follows:

<w:font w:name="Times New Roman">
  <w:sig w:usb0="20002A87" ... />
  ...
</w:font>

The usb0 attribute value of 20002A87 specifies that the first 32 bits of the bitfield are 00100000000000000010101010000111, which corresponds to:

  • Basic Latin
  • Latin-1 Supplement
  • Latin Extended-A
  • Basic Greek
  • Cyrillic
  • Basic Hebrew
  • Basic Arabic
  • Latin Extended Additional

end example]

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

usb1 (Second 32 Bits of Unicode Subset Bitfield)

Specifies the second 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard.

[Example: Consider font information specified as follows:

<w:font w:name="Times New Roman">
  <w:sig w:usb1="80000000" ... />
  ...
</w:font>

The usb0 attribute value of 80000000 specifies that the first 32 bits of the bitfield are 10000000000000000000000000000000, which corresponds to:

  • Arabic Presentation Forms-A

end example]

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

usb2 (Third 32 Bits of Unicode Subset Bitfield)

Specifies the third 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard.

[Example: Consider font information specified as follows:

<w:font w:name="Times New Roman">
  <w:sig w:usb2="00000008" ... />
  ...
</w:font>

The usb0 attribute value of 80000000 specifies that the first 32 bits of the bitfield are 00000000000000000000000000001000, which corresponds to:

  • Arabic Presentation Forms-B

end example]

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

usb3 (Fourth 32 Bits of Unicode Subset Bitfield)

Specifies the fourth 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard.

[Example: Consider font information specified as follows:

<w:font w:name="Times New Roman">
  <w:sig w:usb3="00000000" ... />
  ...
</w:font>

The usb3 attribute value of 00000000 specifies that the first 32 bits of the bitfield are 00000000000000000000000000000000, which corresponds to no subranges. end example]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_FontSig">

<attribute name="usb0" use="required" type="ST_LongHexNumber"/>

<attribute name="usb1" use="required" type="ST_LongHexNumber"/>

<attribute name="usb2" use="required" type="ST_LongHexNumber"/>

<attribute name="usb3" use="required" type="ST_LongHexNumber"/>

<attribute name="csb0" use="required" type="ST_LongHexNumber"/>

<attribute name="csb1" use="required" type="ST_LongHexNumber"/>

</complexType>


Converted to HTML format by ooxmlspec2html 0.1, a Perl script provided by OpenISO.org.