TextElement.FontFamily Propiedad

Definición

Obtiene o establece la familia de fuentes de nivel superior preferida para el contenido del elemento.Gets or sets the preferred top-level font family for the content of the element.

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; }
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

Valor de propiedad

Un 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 that specifies 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.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el atributo FontFamily, utilizando Paragraph como elemento de ejemplo.The following example shows how to set the FontFamily attribute, using Paragraph as the example element.

<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.The following figure shows how the preceding example renders.

captura de pantalla: Texto con propiedades de texto establecidasScreenshot: Text with text properties set

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

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 segunda y subsiguiente 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 se aplique.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 solo especifica una preferencia.This property specifies a preference only. Si la familia de fuentes especificada no está disponible, el FlowDocument recurre de forma silenciosa a la fuente determinada por el valor de MessageFontFamily.If the specified font family is not available, the FlowDocument 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 TextElement.FontFamily="value".../>, donde el objeto es un elemento de objeto (normalmente un elemento de flujo) incluido en un TextBlocky el valor es uno de los valores de formato de cadena, tal como se explica en valores XAML.In XAMLXAML, the usage is <object TextElement.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 los métodos GetFontFamily y SetFontFamily.In code, the attached property usage is supported by the GetFontFamily and SetFontFamily methods. El uso de la propiedad adjunta no es habitual, porque la mayoría de los elementos que se pueden incluir en un TextElement admiten una propiedad FontFamily análoga no adjunta, que el host de contenido utiliza para la representación.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontFamily property, which the content host 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
Una cadena que especifica varios nombres de familia de fuentes, separados por una coma (se omite cualquier espacio 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; las familias de fuentes subsiguientes 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.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 la familia de fuentes principal, con Century Gothic como 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 la familia de fuentes están delimitados por 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
Cadena que especifica un identificador uniforme de recursos (URI) para la fuente, junto con un nombre de familia de fuentes.A string specifying a uniform resource identifier (URI) for the font, along with a font family name. El URI y el nombre de la familia de fuentes están delimitados por un carácter #.The URI 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
Propiedades de metadatos establecidas en trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Se aplica a