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の属性をTextBlock要素。The 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".../>ここで、オブジェクト内に含まれるオブジェクト要素 (通常はフローの要素)、TextBlockとして文字列形式の値の 1 つですXAML 値について説明します。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と同様、非添付のサポートFontFamilyプロパティが、TextBlockレンダリングに使用します。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 世紀ゴートとして代替フォント ファミリと、プライマリ フォント ファミリを指定します。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

適用対象