TextBlock.FontFamily 屬性

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

取得或設定慣用的 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

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 設定會覆寫此最上層設定。

指定多個系列時，第二個和後續字型系列可作為後援系列，以供主要字型系列無法使用或不適用時使用。

此屬性僅指定喜好設定。 如果指定的字型系列無法使用，則會 TextBlock 以無訊息方式回復為值所決定的字型 MessageFontFamily 。

這個相依性屬性也有附加的屬性使用方式。 在 XAML 中，使用方式是 <object TextBlock.FontFamily="value".../> ，其中 object 是物件專案 (通常是包含在 內的 TextBlock 流程專案) ，而 值 是 XAML 值中所述的其中一個字串格式值。 在程式碼中，和 SetFontFamily 支援 GetFontFamily 附加屬性使用方式。 附加屬性使用方式並不常見，因為大部分可以包含在 TextBlock 中的元素都支援類似的非附加 FontFamily 屬性，以供 TextBlock 轉譯使用。

XAML Attribute Usage

<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 為後援字型系列。

fontFamilyFolderReference
指定包含字型的資料夾以及字型系列名稱的字串。 資料夾和字型系列名稱是以 # 字元分隔。 資料夾參考可能是絕對或相對的。 例如： "Custom Fonts\#My Custom Font" 。

fontFamilyUriReference
字串，指定字型的統一資源識別項 (URI) ，以及字型系列名稱。 URI 和字型系列名稱是以 # 字元分隔。 例如： "http://MyFontServer/Fonts/#My Custom Font" 。

相依性屬性資訊

識別碼欄位	FontFamilyProperty
設定為 的中繼資料屬性 true	AffectsMeasure, AffectsRender, Inherits