TextBlock.FontFamily TextBlock.FontFamily TextBlock.FontFamily TextBlock.FontFamily Property

定義

TextBlock のトップレベルの優先フォント ファミリを取得または設定します。Gets or sets the preferred top-level font family for the 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; }
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily

プロパティ値

優先フォント ファミリ (1 つ以上の代替フォント ファミリを持つ第一に優先されるフォント ファミリ) を指定する FontFamily オブジェクト。A FontFamily object specifying 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を設定する方法を次の例に示します。 TextBlockThe following example shows how to set the FontFamily attribute of a TextBlock element.

<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使用してプロパティを設定する方法を示します。The following example shows how to set the FontFamily property programmatically.

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要素の設定は、この最上位レベルの設定よりも優先されます。Any FontFamily settings on child elements override this top-level setting.

複数のファミリが指定されている場合、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. 指定したフォントファミリが使用できない場合TextBlock 、は、 MessageFontFamily値によって決定されたフォントに自動的にフォールバックします。If the specified font family is not available, the TextBlock silently falls back to the font determined by the MessageFontFamily value.

この依存関係プロパティには、プロパティの使用法も添付されています。This dependency property also has an attached property usage. XAMLXAMLは、が使用<object TextBlock.FontFamily="value".../>されます。ここで、 objectは、に含まれるTextBlockオブジェクト要素 (通常はフロー要素) です。 valueは、「XAML 値」で説明されているように、文字列形式の値の1つです。In XAMLXAML, the usage is <object TextBlock.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. コードでは、添付プロパティの使用はGetFontFamilySetFontFamilyでサポートされています。In code, the attached property usage is supported by GetFontFamily and SetFontFamily. 添付プロパティの使用は一般的ではありません。これは、にTextBlock含まれる可能性のあるほとんどの要素が、 TextBlockレンダリングに使用する類似の非添付FontFamilyプロパティをサポートするためです。The attached property usage is not common, because most elements that can be contained in a TextBlock support an analogous nonattached FontFamily property, which the TextBlock 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)uniform resource identifier (URI) 、フォントファミリ名と共に指定する文字列。A string specifying a Uniform Resource Identifier (URI)uniform resource identifier (URI) for the font, along with a font family name. URIURIとフォントファミリ名は、# 文字で区切られます。The URIURI 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 AffectsMeasureAffectsRenderInheritsAffectsMeasure, AffectsRender, Inherits

適用対象