TextBlock.FontFamily Propiedad

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Obtiene o establece la familia de fuentes de nivel superior preferida para el 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; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font)>]
member this.FontFamily : System.Windows.Media.FontFamily with get, set

Public Property FontFamily As FontFamily

Valor de propiedad

FontFamily

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. El valor predeterminado es la fuente que determina el valor de MessageFontFamily.

Atributos

LocalizabilityAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el FontFamily atributo de un TextBlock elemento .

<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>

En el ejemplo siguiente se muestra cómo establecer la propiedad FontFamily mediante programación.

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 configuración de los elementos secundarios invalida esta configuración de nivel superior.

Cuando se especifican varias familias, las familias de fuentes segundas y posteriores sirven como familias de reserva que se usarán en los casos en los que la familia de fuentes principal no esté disponible o no sea aplicable.

Esta propiedad especifica solo una preferencia. Si la familia de fuentes especificada no está disponible, la TextBlock reserva silenciosamente a la fuente determinada por el MessageFontFamily valor .

Esta propiedad de dependencia también tiene un uso de propiedad adjunta. En XAML, el uso es <object TextBlock.FontFamily="value".../>, donde object es un elemento de objeto (normalmente un elemento flow) contenido en , TextBlocky value es uno de los valores de formato de cadena, como se explica en Valores XAML. En el código, el uso de la propiedad adjunta es compatible con GetFontFamily y SetFontFamily. El uso de la propiedad adjunta no es común, ya que la mayoría de los elementos que se pueden contener en una TextBlock compatibilidad con una propiedad análoga no adjunta FontFamily , que usa TextBlock para la representación.

Uso de atributos XAML

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

Valores XAML

fontFamilyName
Cadena que especifica un nombre de familia de fuentes.  Por ejemplo, "Arial" o "Century Gothic".

fontFamilyNamesList
Cadena que especifica varios nombres de familia de fuentes, cada uno separado por una coma (se omite cualquier espacio en blanco después de una coma). La primera familia de fuentes especificada actúa como la familia de fuentes principal; las familias de fuentes posteriores sirven como familias de reserva que se usarán en los casos en los que la familia de fuentes principal no está disponible o no es aplicable. Por ejemplo, "Arial, Century Gothic" especifica Arial como la familia de fuentes principal, con Century Gothic como familia de fuentes de reserva.

fontFamilyFolderReference
Cadena que especifica una carpeta que contiene la fuente, junto con un nombre de familia de fuentes. El nombre de la familia de fuentes y la carpeta están delimitados por un carácter # . La referencia de carpeta puede ser absoluta o relativa. Por ejemplo, "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Cadena que especifica un identificador uniforme de recursos (URI) para la fuente, junto con un nombre de familia de fuentes. El URI y el nombre de familia de fuentes se delimitan mediante un carácter # . Por ejemplo, "http://MyFontServer/Fonts/#My Custom Font".

Información sobre propiedades de dependencia

Campo identificador	FontFamilyProperty
Propiedades de metadatos establecidas en true	AffectsMeasure, AffectsRender, Inherits