FontCapitals Enum

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Describes the capital letter style for a Typography object.

public enum class FontCapitals

public enum FontCapitals

type FontCapitals =

Public Enum FontCapitals

Inheritance: Object

ValueType

Enum
FontCapitals

Fields

Name	Value	Description
Normal	0	Capital letters render normally.
AllSmallCaps	1	Both capital and lowercase letters are replaced with a glyph form of an uppercase letter with the same approximate height.
SmallCaps	2	Lowercase letters are replaced with a glyph form of an uppercase letter with the same approximate height.
AllPetiteCaps	3	Both capital and lowercase letters are replaced with a glyph form of an uppercase letter with the same approximate height. Petite capitals are smaller than small capitals.
PetiteCaps	4	Lowercase letters are replaced with a glyph form of an uppercase letter with the same approximate height. Petite capitals are smaller than small capitals.
Unicase	5	Capital letters display in unicase. Unicase fonts render both upper and lowercase letters in a mixture of upper and lowercase glyphs determined by the type designer.
Titling	6	Glyph forms are substituted with a typographic form specifically designed for titles.

Examples

The following code example shows how to define capitals for the Pescadero font, using properties of the Typography object. When the "SmallCaps" format is used, any leading capital letter is ignored.

<Paragraph FontFamily="Pescadero" FontSize="48">
  <Run>CAPITALS</Run>
  <Run Typography.Capitals="SmallCaps">Capitals</Run>
  <Run Typography.Capitals="AllSmallCaps">Capitals</Run>
</Paragraph>

The following code example shows how to define titling capitals for the Pescadero font, using properties of the Typography object.

<Paragraph FontFamily="Pescadero">
  <Run Typography.Capitals="Titling">chapter one</Run>
</Paragraph>

Remarks

Capitals are a set of typographical forms that render text in capital-styled glyphs. Typically, when text is rendered as all capitals, the spacing between letters can appear too tight, and the weight and proportion of the letters too heavy. OpenType supports a number of styling formats for capitals, including small capitals, petite capitals, titling, and capital spacing. These styling formats allow you to control the appearance of capitals.

The following text displays standard capital letters for the Pescadero font, followed by the letters styled as "SmallCaps" and "AllSmallCaps". In this case, the same font size is used for all three words.

Text using OpenType capitals
Example of capitals

Titling capitals are lighter in weight and proportion and designed to give a more elegant look than normal capitals. Titling capitals are typically used in larger font sizes as headings. The following text displays normal and titling capitals for the Pescadero font. Notice the narrower stem widths of the text on the second line.

Text using OpenType titling capitals
Example of normal and titling capitals

Note

Most OpenType fonts expose only a subset of the total OpenType features available.

Applies to

Jaa