TextBlock.FontFamily TextBlock.FontFamily TextBlock.FontFamily TextBlock.FontFamily Property

Definición

Obtiene o establece la familia de fuentes de nivel superior preferida para el TextBlock.Gets or sets the preferred top-level font family for the TextBlock.

public:
 property System::Windows::Media::FontFamily ^ FontFamily { System::Windows::Media::FontFamily ^ get(); void set(System::Windows::Media::FontFamily ^ value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.Font)]
public System.Windows.Media.FontFamily FontFamily { get; set; }
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

Valor de propiedad

Objeto FontFamily que especifica la familia de fuentes preferida o una familia de fuentes preferida primaria con una o más familias de fuentes de reserva.A FontFamily object specifying the preferred font family, or a primary preferred font family with one or more fallback font families. El valor predeterminado es la fuente que determina el valor de MessageFontFamily.The default is the font determined by the MessageFontFamily value.

Ejemplos

El ejemplo siguiente muestra cómo establecer el FontFamily atributo de un TextBlock elemento.The following example shows how to set the FontFamily attribute of a TextBlock element.

<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

El ejemplo siguiente muestra cómo establecer el FontFamily propiedad mediante programación.The following example shows how to set the FontFamily property programmatically.

TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;
Dim textBlock As New TextBlock(New Run("A bit of text content..."))

textBlock.Background = Brushes.AntiqueWhite
textBlock.Foreground = Brushes.Navy

textBlock.FontFamily = New FontFamily("Century Gothic")
textBlock.FontSize = 12
textBlock.FontStretch = FontStretches.UltraExpanded
textBlock.FontStyle = FontStyles.Italic
textBlock.FontWeight = FontWeights.UltraBold

textBlock.LineHeight = Double.NaN
textBlock.Padding = New Thickness(5, 10, 5, 10)
textBlock.TextAlignment = TextAlignment.Center
textBlock.TextWrapping = TextWrapping.Wrap

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle
textBlock.Typography.SlashedZero = True

Comentarios

Cualquier FontFamily en elementos secundarios invalida esta configuración de nivel superior.Any FontFamily settings on child elements override this top-level setting.

Cuando se especifican varias familias, las familias de fuentes de la segunda y posteriores actúan como familias de reserva para su uso en casos donde la familia de fuentes primaria no está disponible o no es aplicable.When multiple families are specified, the second and subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable.

Esta propiedad especifica solo una preferencia.This property specifies a preference only. Si la familia de fuentes especificada no está disponible, el TextBlock silenciosamente recurre a la fuente determinada por la MessageFontFamily valor.If the specified font family is not available, the TextBlock silently falls back to the font determined by the MessageFontFamily value.

Esta propiedad de dependencia también tiene un uso de la propiedad adjunta.This dependency property also has an attached property usage. En XAMLXAML, el uso es <object TextBlock.FontFamily="value".../>, donde objeto es un elemento de objeto (normalmente un elemento de flujo) dentro de un TextBlock, y valor es uno de los valores de cadena con formato como se explica en los valores de XAML.In XAMLXAML, the usage is <object TextBlock.FontFamily="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is one of the string-format values as explained in XAML Values. En el código, el uso de la propiedad adjunta es compatible con GetFontFamily y SetFontFamily.In code, the attached property usage is supported by GetFontFamily and SetFontFamily. El uso de la propiedad adjunta no es común, porque la mayoría de los elementos que puede incluirse en un TextBlock soporte un análogo nonattached FontFamily propiedad, que el TextBlock utiliza para la representación.The attached property usage is not common, because most elements that can be contained in a TextBlock support an analogous nonattached FontFamily property, which the TextBlock uses for rendering.

Uso de atributos XAMLXAML Attribute Usage

<object FontFamily="fontFamilyName"/>  
- or -  
<object FontFamily="fontFamilyNamesList"/>  
- or -  
<object FontFamily="fontFamilyFolderReference"/>  
- or -  
<object FontFamily="fontFamilyUriReference"/>  

Valores XAMLXAML Values

fontFamilyNamefontFamilyName
Cadena que especifica un nombre de familia de fuentes.A string specifying a font family name. Por ejemplo: "Arial" o "Century Gothic".For example, "Arial" or "Century Gothic".

fontFamilyNamesListfontFamilyNamesList
Cadena que especifica varios nombres de familia de fuentes, separados por punto y coma (se omiten los espacios en blanco después de una coma).A string specifying multiple font family names, each separated by a comma (any white space following a comma is ignored). La primera familia de fuentes especificada actúa como la familia de fuentes primaria; familias de fuentes subsiguientes actúan como familias de reserva para su uso en casos donde la familia de fuentes primaria no está disponible o no es aplicable.The first font family specified serves as the primary font family; subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable. Por ejemplo, "Arial, Century Gothic" especifica Arial como familia de fuentes primaria, con siglo gótica como la familia de fuentes de reserva.For example, "Arial, Century Gothic" specifies Arial as the primary font family, with Century Gothic as the fallback font family.

fontFamilyFolderReferencefontFamilyFolderReference
Cadena que especifica una carpeta que contiene la fuente, junto con un nombre de familia de fuentes.A string specifying a folder containing the font, along with a font family name. La carpeta y el nombre de familia de fuentes se delimitan mediante un carácter #.The folder and font family name are delimited by a # character. La referencia a la carpeta puede ser absoluta o relativa.The folder reference may be absolute, or relative. Por ejemplo: "Custom Fonts\#My Custom Font".For example, "Custom Fonts\#My Custom Font".

fontFamilyUriReferencefontFamilyUriReference
Una cadena que especifica un identificador de recursos uniforme (URI)uniform resource identifier (URI) para la fuente, junto con un nombre de familia de fuentes.A string specifying a identificador de recursos uniforme (URI)uniform resource identifier (URI) for the font, along with a font family name. El Identificador URIURI y nombre de familia de fuentes se delimitan mediante un carácter #.The Identificador URIURI and font family name are delimited by a # character. Por ejemplo: "http://MyFontServer/Fonts/#My Custom Font".For example, "http://MyFontServer/Fonts/#My Custom Font".

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field FontFamilyProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Se aplica a