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; }
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

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

Объект FontFamily, задающий предпочтительное семейство шрифтов, или основное предпочтительное семейство шрифтов с одним или несколькими резервными семействами шрифтов.A FontFamily object that specifies 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. В XAMLXAMLиспользование <object TextElement.FontFamily="value".../>, где Object — это объектный элемент (обычно элемент Flow), содержащийся в TextBlock, а value — одно из значений строкового формата, как описано в значениях XAML.In XAMLXAML, 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

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