TextBlock.FontFamily プロパティ

定義

TextBlock に対して、優先される最上位レベルのフォント ファミリを取得または設定します。

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)]
public System.Windows.Media.FontFamily FontFamily { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font)>]
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

プロパティ値

FontFamily

優先フォント ファミリ、または優先されるプライマリ フォント ファミリと 1 つ以上の代替フォント ファミリを指定する FontFamily オブジェクト。 既定値は、MessageFontFamily 値によって決まるフォントです。

属性

次の例は、要素の属性を設定する FontFamily 方法を TextBlock 示しています。

<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

次の例では、FontFamily プロパティをプログラムで設定する方法を示しています。

TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;
Dim textBlock As New TextBlock(New Run("A bit of text content..."))

textBlock.Background = Brushes.AntiqueWhite
textBlock.Foreground = Brushes.Navy

textBlock.FontFamily = New FontFamily("Century Gothic")
textBlock.FontSize = 12
textBlock.FontStretch = FontStretches.UltraExpanded
textBlock.FontStyle = FontStyles.Italic
textBlock.FontWeight = FontWeights.UltraBold

textBlock.LineHeight = Double.NaN
textBlock.Padding = New Thickness(5, 10, 5, 10)
textBlock.TextAlignment = TextAlignment.Center
textBlock.TextWrapping = TextWrapping.Wrap

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle
textBlock.Typography.SlashedZero = True

注釈

FontFamily子要素のすべての設定は、この最上位レベルの設定をオーバーライドします。

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

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

この依存関係プロパティには、プロパティの使用法も添付されています。 XAML では、オブジェクトは<object TextBlock.FontFamily="value".../>オブジェクト 要素 (通常はフロー要素) 内にTextBlock含まれており、 は XAML 値で説明されている文字列形式の値の 1 つです。 コードでは、添付プロパティの使用がサポートされていますGetFontFamilySetFontFamily。 添付プロパティの使用は一般的ではありません。ほとんどの要素は、レンダリングに TextBlock 使用される類似の非アタッチプロパティ FontFamilyTextBlock サポートしているためです。

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
メタデータのプロパティが次に設定されている true AffectsMeasureAffectsRenderInherits

適用対象