TextBlock.FontFamily Propriedade

Definição

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

Um objeto que especifica a família de fontes preferida, ou uma família de fontes preferidas primária com uma ou mais famílias de FontFamily fontes de recurso. O padrão é a fonte determinada pelo MessageFontFamily valor.

Atributos

Exemplos

O exemplo seguinte mostra como definir o FontFamily atributo de um 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>

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

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

Observações

Quaisquer FontFamily definições nos elementos filhos sobrepõem-se a esta definição de topo.

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 TextBlock 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 TextBlock.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 por GetFontFamily e SetFontFamily. O uso da propriedade anexada não é comum, porque a maioria dos elementos que podem ser contidos num TextBlock suporte a uma propriedade não anexada FontFamily análoga, que o TextBlock uso é 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