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

プロパティ値

優先フォント ファミリ、または優先されるプライマリ フォント ファミリと 1 つ以上の代替フォント ファミリを指定する 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.

属性

次の例では、Paragraph を例の要素として使用して、FontFamily 属性を設定する方法を示します。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

注釈

複数のファミリが指定されている場合、2番目以降のフォントファミリはフォールバックファミリとして機能し、プライマリフォントファミリが使用できない場合、または適用できない場合に使用されます。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".../>になります。ここで、 objectTextBlock内に含まれるオブジェクト要素 (通常はフロー要素) です。 valueは、「XAML 値」で説明されているように、文字列形式の値の1つです。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.

XAML 属性の使用方法XAML Attribute Usage

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

XAML 値XAML Values

fontFamilyNamefontFamilyName
フォントファミリ名を指定する文字列。A string specifying a font family name. たとえば、"Arial" または "Century Gothic" のようにします。For example, "Arial" or "Century Gothic".

fontFamilyNamesListfontFamilyNamesList
コンマで区切られた複数のフォントファミリ名を指定する文字列 (コンマの後の空白は無視されます)。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 をプライマリフォントファミリとして指定し、代替フォントファミリとして Century ゴシックを指定します。For example, "Arial, Century Gothic" specifies Arial as the primary font family, with Century Gothic as the fallback font family.

fontFamilyFolderReferencefontFamilyFolderReference
フォントファミリ名と共に、フォントを含むフォルダーを指定する文字列。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".

fontFamilyUriReferencefontFamilyUriReference
フォントファミリ名と共に、フォントの uniform resource identifier (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
メタデータプロパティが true に設定されるMetadata properties set to true AffectsMeasureAffectsRenderInheritsAffectsMeasure, AffectsRender, Inherits

適用対象