TextElement.FontFamily Свойство

Определение

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

System.Windows.Documents

Сборка:

PresentationFramework.dll

Возвращает или задает предпочитаемое семейство шрифтов верхнего уровня для содержимого элемента.

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

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

FontFamily

Предпочтительное семейство шрифтов или основное предпочитаемое семейство шрифтов с одним или несколькими резервными семействами шрифтов. По умолчанию используется шрифт, определенный значением MessageFontFamily .

Атрибуты

LocalizabilityAttribute

Примеры

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

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

На следующем рисунке показано, как отрисовывается предыдущий пример.

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

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

Комментарии

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

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

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

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

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

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

Элемент	Ценность
Поле идентификатора	FontFamilyProperty
Свойства метаданных, равные свойству true	AffectsMeasure, AffectsRender, Inherits