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

優先フォント ファミリ、または 1 つ以上のフォールバック フォント ファミリを持つ主要な優先フォント ファミリ。 既定値は、MessageFontFamily 値によって決まるフォントです。

属性

LocalizabilityAttribute

例

次の例では、Paragraph を例の要素として使用して、FontFamily 属性を設定する方法が示されています。

<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

注釈

複数のファミリを指定すると、2 番目以降のフォント ファミリは、プライマリ フォント ファミリが使用できない場合や適用できない場合に使用されるフォールバック ファミリとして機能します。

このプロパティは、基本設定のみを指定します。 指定したフォント ファミリが使用できない場合、 は値 FlowDocument によって決定されたフォントに自動的に MessageFontFamily フォールバックします。

この依存関係プロパティには、添付プロパティの使用法もあります。 XAML では、使用法は です <object TextElement.FontFamily="value".../>。 object は 内 TextBlockに含まれるオブジェクト要素 (通常はフロー要素) であり、 値 は XAML 値で説明されているように文字列形式の値の 1 つです。 コードでは、 メソッドと SetFontFamily メソッドで添付プロパティの使用がGetFontFamilyサポートされています。 添付プロパティの使用は一般的ではありません。これは、 に 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
フォントの UNIFORM リソース識別子 (URI) とフォント ファミリ名を指定する文字列。 URI とフォント ファミリ名は、 # 文字で区切られます。 たとえば、「 "http://MyFontServer/Fonts/#My Custom Font" 」のように入力します。

依存プロパティ情報

識別子フィールド	FontFamilyProperty
に設定されたメタデータ プロパティ true	AffectsMeasure, AffectsRender, Inherits