TextBlock.FontFamily プロパティ

リファレンス

定義

名前空間:: System.Windows.Controls

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 値によって決まるフォントです。

属性: LocalizabilityAttribute

例

次の例は、要素の属性を設定する 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 つです。コードでは、添付プロパティの使用がサポートされていますGetFontFamily SetFontFamily。添付プロパティの使用は一般的ではありません。ほとんどの要素は、レンダリングに TextBlock 使用される類似の非アタッチプロパティ FontFamily を TextBlock サポートしているためです。

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`	AffectsMeasure、AffectsRender、Inherits

適用対象