TextElement.FontFamily Propriedade

Definição

Obtém ou define a família de fontes de topo preferida 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 de Propriedade

A família de fontes preferidas ou uma família de fontes preferidas primárias com uma ou mais famílias de fontes de reserva. O padrão é a fonte determinada pelo MessageFontFamily valor.

Atributos

Exemplos

O exemplo a seguir mostra como definir o atributo FontFamily, 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 seguinte mostra como o exemplo anterior se apresenta.

Captura de ecrã: Texto com propriedades de texto definidas

O exemplo a seguir mostra como definir a propriedade FontFamily 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

Observações

Quando múltiplas famílias são especificadas, a segunda e as seguintes famílias de fontes servem como famílias de recurso a serem usadas nos casos em que a família principal de fontes não está disponível ou não é aplicável.

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

Esta propriedade de dependência também tem um uso associado à propriedade. Em XAML, a utilização é <object TextElement.FontFamily="value".../>, onde o objeto é um elemento objeto (tipicamente um elemento de fluxo) contido dentro de um TextBlock, e o valor é um dos valores de formato de string, conforme explicado em Valores XAML. No código, o uso da propriedade associada é suportado pelos GetFontFamily métodos e.SetFontFamily O uso de propriedades anexadas não é comum, porque a maioria dos elementos que podem ser contidos num TextElement suporte suporta uma propriedade não anexada FontFamily análoga, que o anfitrião de conteúdo usa para renderização.

Uso de atributos XAML

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

Valores XAML

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

fonteFamíliaNomesLista Uma cadeia que especifica vários nomes de famílias 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 principal de fontes; As famílias de fontes subsequentes servem como famílias de reserva a serem usadas nos casos em que a família principal de fontes não está disponível ou não é aplicável. Por exemplo, "Arial, Century Gothic" especifica Arial como a família principal de fontes, com Century Gothic como família de fontes de recurso.

fontFamilyFolderReference Uma cadeia que especifica uma pasta contendo a fonte, juntamente com o nome da família da fonte. A pasta e o nome da família da fonte são delimitados por um carácter #. A referência à pasta pode ser absoluta ou relativa. Por exemplo, "Custom Fonts\#My Custom Font".

fontFamilyUriReference Uma cadeia que especifica um identificador uniforme de recurso (URI) para a fonte, juntamente com um nome de família de fontes. O URI e o nome da família da fonte são delimitados por um carácter #. Por exemplo, "http://MyFontServer/Fonts/#My Custom Font".

Informação de Propriedade de Dependência

Iteme Value
Campo identificador FontFamilyProperty
Propriedades dos metadados definidas como true AffectsMeasure, AffectsRender, Inherits

Aplica-se a