TextElement.FontSize 属性

定义

命名空间:

System.Windows.Documents

程序集:

PresentationFramework.dll

获取或设置元素内容的字体大小。

public:
 property double FontSize { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.FontSizeConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None)]
public double FontSize { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.FontSizeConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None)>]
member this.FontSize : double with get, set

Public Property FontSize As Double

属性值

Double

要以与设备无关的像素表示的所需字号，大于 0.001 且小于或等于 35791。 默认值取决于当前的系统设置和 MessageFontSize 值。

属性

TypeConverterAttribute LocalizabilityAttribute

例外

ArgumentException

FontSize 设置为大于 35791 或小于或等于 0.001 的值。

示例

以下示例将 Paragraph 作为示例元素，演示如何设置 FontSize 属性。

<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>

下图显示了上述示例的呈现方式。

以下示例演示如何以编程方式设置 FontSize 属性。

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

注解

此依赖属性还具有附加属性用法。 在 XAML 中，用法为 <object TextElement.FontSize="value".../>，其中 object 是对象元素 (通常是包含在 中的 TextElement流元素) ， 值 是 XAML 值中所述的字符串格式值之一。 在代码中，和 SetFontSize 方法支持GetFontSize附加属性用法。 附加属性用法并不常见，因为可以包含在 中的 TextElement 大多数元素都支持类似的非附加 FontSize 属性，内容主机使用该属性进行呈现。

XAML 属性用法

<object FontSize="double"/>  
- or -  
<object FontSize="qualifiedDouble"/>  

XAML 值

double
Double

值等于或大于 0.0 但小于 PositiveInfinity的字符串表示形式Double。 非限定值以与设备无关的像素度量。 字符串不需要显式包含小数点。

qualifiedDouble
如上所述的双精度值，后跟下列单位说明符之一：px、、in、cmpt。

px (默认) 为与设备无关的单位， (单位) 1/96 英寸

in 为英寸;1in==96px

cm 为厘米;1cm== (96/2.54) px

pt 是点;1pt== (96/72) px

依赖项属性信息

标识符字段	FontSizeProperty
元数据属性设置为 true	AffectsMeasure, AffectsRender, Inherits