TextBlock.FontFamily Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Получает или задает предпочтительное семейство шрифтов верхнего уровня для 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

Значение свойства

FontFamily

Объект FontFamily, задающий предпочтительное семейство шрифтов, или основное предпочтительное семейство шрифтов с одним или несколькими резервными семействами шрифтов. Шрифт по умолчанию определяется значением MessageFontFamily.

Атрибуты

LocalizabilityAttribute

Примеры

В следующем примере показано, как задать FontFamily атрибут TextBlock элемента.

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

В следующем примере показано, как программно задать FontFamily свойство.

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

Комментарии

Все FontFamily параметры дочерних элементов переопределяют этот параметр верхнего уровня.

Если указано несколько семейств, второй и последующий семейства шрифтов служат резервными семействами, которые будут использоваться в тех случаях, когда основное семейство шрифтов недоступно или неприменимо.

Это свойство задает только предпочтение. Если указанное семейство шрифтов недоступно, TextBlock автоматически возвращается к шрифту, определяемого значением MessageFontFamily .

Это свойство зависимостей также имеет использование присоединенного свойства. В XAML используется <object TextBlock.FontFamily="value".../>объект, где объект является элементом объекта (обычно элементом потока), содержащимся в TextBlockобъекте, а значением является одно из значений строкового формата, как описано в значениях XAML. В коде использование присоединенного свойства поддерживается GetFontFamily и SetFontFamily. Использование присоединенного свойства не является общим, так как большинство элементов, которые могут содержаться в TextBlock поддержке аналогичного неприсоединенного свойства, которое TextBlock используется для отрисовкиFontFamily.

Использование атрибута XAML

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

Значения XAML

fontFamilyName
Строка, указывающая имя семейства шрифтов. Например, "Arial" или "Century Gothic".

fontFamilyNamesList
Строка, указывающая несколько имен семейств шрифтов, каждая из которых отделена запятой (все пробелы после запятой игнорируются). Первое указанное семейство шрифтов служит основным семейством шрифтов; последующие семейства шрифтов служат резервными семействами для использования в тех случаях, когда основное семейство шрифтов недоступно или неприменимо. Например, "Arial, Century Gothic" указывает Arial в качестве основного семейства шрифтов, а Century Gothic — резервным семейством шрифтов.

fontFamilyFolderReference
Строка, указывающая папку, содержащую шрифт, а также имя семейства шрифтов. Имя папки и семейства шрифтов разделяются символом #. Ссылка на папку может быть абсолютной или относительной. Например, "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Строка, указывающая универсальный код ресурса (URI) для шрифта, а также имя семейства шрифтов. URI и имя семейства шрифтов разделяются символом #. Например, "http://MyFontServer/Fonts/#My Custom Font".

Сведения о свойстве зависимостей

Поле идентификатора	FontFamilyProperty
Для свойств метаданных задано значение true	AffectsMeasure, AffectsRender, Inherits