TextBlock.FontFamily Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets or sets the preferred top-level font family for the text content in this element.
Namespace: System.Windows.Controls
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Property FontFamily As FontFamily
public FontFamily FontFamily { get; set; }
<TextBlock FontFamily="fontFamily" />
-or-
<TextBlock FontFamily="fontFamilyName[,fallbackFontFamilyName]" />
-or-
<TextBlock FontFamily="fontURI#fontFamily" />
XAML Values
fontFamily
A single font family name, for example "Verdana".fontFamilyName[,fallbackFontFamilyName]
A primary font family choice then one or more fallback font family choices, for example "Arial Unicode MS, Arial". See Remarks.fontURI#fontFamily
Used for non-default fonts. Specifies the resource location in the assembly for a font file, and a font family within that font. For information on this usage, see FontFamily. For more information on relative URIs for accessing font resources, see Resource Files.
Property Value
Type: System.Windows.Media.FontFamily
A FontFamily object that specifies the preferred font family, or a primary preferred font family with one or more fallback font families. For information about defaults, see the FontFamily class topic.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | FontFamily is nulla null reference (Nothing in Visual Basic). |
Remarks
Dependency property identifier field: FontFamilyProperty
The default value is a FontFamily for "Portable User Interface", which represents a composite font that uses a number of fonts to implement the range of international languages that are supported by Silverlight. This includes Lucida Sans Unicode and Lucida Grande for many Western writing systems, and many more for East Asian writing systems.
For more information, see FontFamily. For a complete list of supported fonts, see Text and Fonts. For information on how to specify a non-default FontFamily, where you distribute a font file as an assembly resource, see FontFamily.
Any FontFamily settings on Run child elements override the settings on the containing TextBlock.
Fallbacks for Fonts, as Specified in XAML
When multiple families are specified, the second and subsequent font families serve as fallback families to use if the primary font family is unavailable or not applicable. To specify multiple font families, use the following syntax:
fontFamilyName[,fallbackFontFamilyName]
In this syntax, fontFamilyName specifies the primary font, and fallbackFontFamilyName specifies an optional fallback. More than one fallback can be specified. Use commas to separate each font family string. To avoid ambiguity, if a font family contains a comma (",") in the name, each single comma in a font family reference must be replaced with a double comma (",,").
This property specifies a preference only. If the specified font family is not available, the TextBlock falls back silently to the "Portable User Interface" composite font.
.gif "Note") Note: |
|---|
Most font files are licensed rather than sold, and licenses that govern the use of fonts vary from vendor to vendor. It is your responsibility to make sure that you have the required license rights for any font that you embed in a document or application, or that you otherwise redistribute. |
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also