TextBlock.FontFamily Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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

FontFamily

Um objeto FontFamily que especifica a família de fontes preferenciais ou uma família principal de fontes preferenciais 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 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 FontFamily propriedade 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

Comentários

Todas FontFamily as configurações em elementos filho substituem essa configuração de nível superior.

Quando várias famílias são especificadas, a segunda e 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 não está disponí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, o TextBlock silenciosamente retornará à fonte determinada pelo MessageFontFamily valor.

Essa propriedade de dependência também tem um uso de propriedade anexado. Em XAML, o uso é <object TextBlock.FontFamily="value".../>, em que object é um elemento de objeto (normalmente um elemento de fluxo) contido em um TextBlocke value é 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 GetFontFamily e SetFontFamily. O uso da propriedade anexada não é comum, pois a maioria dos elementos que podem ser contidos em uma TextBlock propriedade análoga não desanexada FontFamily , que o TextBlock 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 não está disponí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