TextElement.FontFamily Propriedade

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtém ou define a família de fontes preferencial de nível superior para o conteúdo do 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 da propriedade

FontFamily

A família de fontes preferida ou uma família de fontes preferencial primária com uma ou mais famílias de fontes de fallback. O padrão é a fonte determinada pelo valor MessageFontFamily.

Atributos

LocalizabilityAttribute

Exemplos

O exemplo a seguir mostra como definir o FontFamily atributo, usando Paragraph como o elemento de exemplo.

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

A figura a seguir mostra como o exemplo anterior é renderizado.

O exemplo a seguir mostra como definir a FontFamily propriedade programaticamente.

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

Comentários

Quando várias famílias são especificadas, as segundas e subsequentes famílias de fontes servem como famílias de fallback a serem usadas em casos em que a família de fontes primária está indisponível ou não é aplicável.

Essa propriedade especifica apenas uma preferência. Se a família de fontes especificada não estiver disponível, a FlowDocument fonte silenciosamente retornará à fonte determinada pelo MessageFontFamily valor.

Essa propriedade de dependência também tem um uso de propriedade anexado. No XAML, o uso é <object TextElement.FontFamily="value".../>, onde o objeto é um elemento de objeto (normalmente um elemento de fluxo) contido em um TextBlock, e o valor é um dos valores de formato de cadeia de caracteres, conforme explicado em Valores XAML. No código, o uso da propriedade anexada é compatível com os métodos e SetFontFamily os GetFontFamily métodos. O uso da propriedade anexada não é comum, pois a maioria dos elementos que podem ser contidos em uma TextElement propriedade nãonattached FontFamily análoga, que o host de conteúdo usa para renderização.

Uso do Atributo XAML

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

Valores XAML

fontFamilyName
Uma cadeia de caracteres que especifica um nome de família de fontes. Por exemplo, "Arial" ou "Century Gothic".

fontFamilyNamesList
Uma cadeia de caracteres que especifica vários nomes de família de fontes, cada um separado por uma vírgula (qualquer espaço em branco após uma vírgula é ignorado). A primeira família de fontes especificada serve como a família de fontes primária; as famílias de fontes subsequentes servem como famílias de fallback a serem usadas nos casos em que a família de fontes primária está indisponível ou não é aplicável. Por exemplo, "Arial, Century Gothic" especifica Arial como a família de fontes primária, com Century Gothic como a família de fontes de fallback.

fontFamilyFolderReference
Uma cadeia de caracteres que especifica uma pasta que contém a fonte, juntamente com um nome de família de fontes. A pasta e o nome da família de fontes são delimitados por um caractere #. A referência de pasta pode ser absoluta ou relativa. Por exemplo, "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Uma cadeia de caracteres que especifica um URI (uniform resource identifier) para a fonte, juntamente com um nome de família de fontes. O URI e o nome da família de fontes são delimitados por um caractere #. Por exemplo, "http://MyFontServer/Fonts/#My Custom Font".

Informações da propriedade de dependência

Campo Identificador	FontFamilyProperty
Propriedades de metadados definidas como true	AffectsMeasure, AffectsRender, Inherits