TextBlock.FontFamily Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 |