TextElement.FontFamily 屬性
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定項目內容慣用的最上層字型家族。
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, Modifiability=System.Windows.Modifiability.Unmodifiable)]
public System.Windows.Media.FontFamily FontFamily { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font, Modifiability=System.Windows.Modifiability.Unmodifiable)>]
member this.FontFamily : System.Windows.Media.FontFamily with get, set
Public Property FontFamily As FontFamily
慣用字型系列或具有一或多個後援字型系列的主要慣用字型系列。 預設為由 MessageFontFamily 值決定的字型。
- 屬性
下列範例示範如何使用 做為範例專案來 Paragraph 設定 FontFamily 屬性。
<Paragraph
FontFamily="Century Gothic, Courier New"
FontSize="16pt"
FontStretch="UltraExpanded"
FontStyle="Italic"
FontWeight="DemiBold"
>
<Run>
This text will use the Century Gothic font (if available), with fallback to Courier New. It
will render with a font size of 16 points in ultra-expanded demi-bold italic.
</Run>
</Paragraph>
下圖顯示上述範例的呈現方式。
下列範例示範如何以程式設計方式設定 FontFamily 屬性。
Run run = new Run(
"This text will use the Century Gothic font (if available), with fallback to Courier New."
+ "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.");
Paragraph par = new Paragraph(run);
par.FontFamily = new FontFamily("Century Gothic, Courier New");
par.FontSize = 16;
par.FontStretch = FontStretches.UltraExpanded;
par.FontStyle = FontStyles.Italic;
par.FontWeight = FontWeights.DemiBold;
Dim run As New Run("This text will use the Century Gothic font (if available), with fallback to Courier New." & "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.")
Dim par As New Paragraph(run)
With par
.FontFamily = New FontFamily("Century Gothic, Courier New")
.FontSize = 16
.FontStretch = FontStretches.UltraExpanded
.FontStyle = FontStyles.Italic
.FontWeight = FontWeights.DemiBold
End With
指定多個系列時,第二個和後續字型系列可作為後援系列,以供主要字型系列無法使用或不適用時使用。
此屬性僅指定喜好設定。 如果指定的字型系列無法使用,則會 FlowDocument 以無訊息方式回復為值所決定的字型 MessageFontFamily 。
這個相依性屬性也有附加的屬性使用方式。 在 XAML 中,使用方式是 <object TextElement.FontFamily="value".../>
,其中 object 是物件專案 (通常是包含在 內的 TextBlock 流程專案) ,而 值 是 XAML 值中所述的其中一個字串格式值。 在程式碼中,和 SetFontFamily 方法支援 GetFontFamily 附加屬性使用方式。 附加屬性使用方式並不常見,因為大部分可以包含在 支援類似非附加 FontFamily
屬性的專案 TextElement ,內容主機會用來轉譯。
<object FontFamily="fontFamilyName"/>
- or -
<object FontFamily="fontFamilyNamesList"/>
- or -
<object FontFamily="fontFamilyFolderReference"/>
- or -
<object FontFamily="fontFamilyUriReference"/>
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 |
產品 | 版本 |
---|---|
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |