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 Gothic в качестве резервного семейства шрифтов.

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

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

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

Поле идентификатора	FontFamilyProperty
Metadata properties set to true	AffectsMeasure, AffectsRender, Inherits