TextElement.FontFamily Свойство

Определение

Возвращает или задает предпочтительное семейство шрифтов верхнего уровня для содержимого элемента.Gets or sets the preferred top-level font family for the content of the element.

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

Предпочтительное семейство шрифтов или первичное предпочтительное семейство шрифтов с одним или несколькими семействами резервных шрифтов.The preferred font family or a primary preferred font family with one or more fallback font families. Шрифт по умолчанию определяется значением MessageFontFamily.The default is the font determined by the MessageFontFamily value.

Атрибуты

Примеры

В следующем примере показано, как задать FontFamily атрибут, используя в Paragraph качестве элемента example.The following example shows how to set the FontFamily attribute, using Paragraph as the example element.

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

На следующем рисунке показано, как отображается предыдущий пример.The following figure shows how the preceding example renders.

Снимок экрана: текст с заданными свойствами текстаScreenshot: Text with text properties set

В следующем примере показано, как задать FontFamily свойство программным способом.The following example shows how to set the FontFamily property programmatically.

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

Комментарии

Если указано несколько семейств, второе и последующие семейства шрифтов служат в качестве резервных семейств для использования в тех случаях, когда первичное семейство шрифтов недоступно или неприменимо.When multiple families are specified, the second and subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable.

Это свойство указывает только предпочтение.This property specifies a preference only. Если указанное семейство шрифтов недоступно, автоматически возвращается FlowDocument к шрифту, определенному MessageFontFamily значением.If the specified font family is not available, the FlowDocument silently falls back to the font determined by the MessageFontFamily value.

Это свойство зависимостей также имеет присоединенные свойства.This dependency property also has an attached property usage. В XAML используется <object TextElement.FontFamily="value".../> , где Object — это объектный элемент (обычно элемент Flow), содержащийся в TextBlock , а значение — одно из значений строкового формата, как описано в значениях XAML.In XAML, the usage is <object TextElement.FontFamily="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is one of the string-format values as explained in XAML Values. В коде использование присоединенного свойства поддерживается GetFontFamily SetFontFamily методами и.In code, the attached property usage is supported by the GetFontFamily and SetFontFamily methods. Использование присоединенного свойства не является распространенным, так как большинство элементов, которые могут содержаться в, TextElement поддерживают аналогичное неприсоединенное FontFamily свойство, которое узел содержимого использует для отрисовки.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontFamily property, which the content host uses for rendering.

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

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

Значения XAMLXAML Values

фонтфамилинамеfontFamilyName
Строка, указывающая имя семейства шрифтов.A string specifying a font family name. Например, "Arial" или "Century Gothic".For example, "Arial" or "Century Gothic".

фонтфамилинамеслистfontFamilyNamesList
Строка, указывающая несколько имен семейств шрифтов, разделенных запятыми (любые пробелы после запятой игнорируются).A string specifying multiple font family names, each separated by a comma (any white space following a comma is ignored). Первое указанное семейство шрифтов выступает в качестве основного семейства шрифтов; последующие семейства шрифтов служат в качестве резервных семейств для использования в тех случаях, когда первичное семейство шрифтов недоступно или неприменимо.The first font family specified serves as the primary font family; subsequent font families serve as fallback families to be used in cases where the primary font family is unavailable or not applicable. Например, в "Arial, Century Gothic" качестве основного семейства шрифтов в качестве семейства резервных шрифтов указан шрифт Arial.For example, "Arial, Century Gothic" specifies Arial as the primary font family, with Century Gothic as the fallback font family.

фонтфамилифолдерреференцеfontFamilyFolderReference
Строка, указывающая папку, содержащую шрифт, а также имя семейства шрифтов.A string specifying a folder containing the font, along with a font family name. Имя папки и семейства шрифтов отделяется символом #.The folder and font family name are delimited by a # character. Ссылка на папку может быть абсолютной или относительной.The folder reference may be absolute, or relative. Например, "Custom Fonts\#My Custom Font".For example, "Custom Fonts\#My Custom Font".

фонтфамилюриреференцеfontFamilyUriReference
Строка, указывающая универсальный код ресурса (URI) для шрифта, а также имя семейства шрифтов.A string specifying a uniform resource identifier (URI) for the font, along with a font family name. URI и имя семейства шрифтов разделяются символом #.The URI and font family name are delimited by a # character. Например, "http://MyFontServer/Fonts/#My Custom Font".For example, "http://MyFontServer/Fonts/#My Custom Font".

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

Поле идентификатораIdentifier field FontFamilyProperty
Свойства метаданных, для которых задано значение trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Применяется к