[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
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:
• The name of the font as used in the document's stories
• (optionally) Font metrics allowing other applications to locate appropriate substitute fonts as needed
• (optionally) Embedded forms of the font
[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">
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>