TextElement.FontFamily Propiedad

Definición

Espacio de nombres:

System.Windows.Documents

Ensamblado:

PresentationFramework.dll

Obtiene o establece la familia de fuentes de nivel superior preferida para el contenido del elemento.

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, Modifiability=System.Windows.Modifiability.Unmodifiable)]
public System.Windows.Media.FontFamily FontFamily { get; set; }

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

Public Property FontFamily As FontFamily

Valor de propiedad

FontFamily

La familia de fuentes preferida o una familia de fuentes preferida principal con una o varias 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, mediante el uso de Paragraph como elemento de ejemplo.

<Paragraph
  FontFamily="Century Gothic, Courier New"  
  FontSize="16pt"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="DemiBold"
>
  <Run>
    This text will use the Century Gothic font (if available), with fallback to Courier New.  It 
    will render with a font size of 16 points in ultra-expanded demi-bold italic.
  </Run>
</Paragraph>

En la ilustración siguiente se muestra cómo se representa el ejemplo anterior.

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

Run run = new Run(
    "This text will use the Century Gothic font (if available), with fallback to Courier New."
    + "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.");
Paragraph par = new Paragraph(run);

par.FontFamily = new FontFamily("Century Gothic, Courier New");
par.FontSize = 16;
par.FontStretch = FontStretches.UltraExpanded;
par.FontStyle = FontStyles.Italic;
par.FontWeight = FontWeights.DemiBold;

Dim run As New Run("This text will use the Century Gothic font (if available), with fallback to Courier New." & "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.")
Dim par As New Paragraph(run)

With par
    .FontFamily = New FontFamily("Century Gothic, Courier New")
    .FontSize = 16
    .FontStretch = FontStretches.UltraExpanded
    .FontStyle = FontStyles.Italic
    .FontWeight = FontWeights.DemiBold
End With

Comentarios

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 FlowDocument 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 TextElement.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 los GetFontFamily métodos 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 TextElement propiedad análoga no adjunta FontFamily , que el host de contenido usa 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