TextElement.FontStretch プロパティ

定義

要素のコンテンツのフォントの伸縮特性を取得または設定します。Gets or sets the font-stretching characteristics for the content of the element.

public:
 property System::Windows::FontStretch FontStretch { System::Windows::FontStretch get(); void set(System::Windows::FontStretch value); };
public System.Windows.FontStretch FontStretch { get; set; }
member this.FontStretch : System.Windows.FontStretch with get, set
Public Property FontStretch As FontStretch

プロパティ値

使用するフォントの伸縮特性を指定する FontStretch 構造体。A FontStretch structure that specifies the desired font-stretching characteristics to use. 既定値は、Normal です。The default is Normal.

次の例では、Paragraph を例の要素として使用して、FontStretch 属性を設定する方法を示します。The following example shows how to set the FontStretch attribute, using Paragraph as the example element.

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

次の図は、前の例がどのようにレンダリングされるかを示しています。The following figure shows how the preceding example renders.

スクリーンショット:テキストプロパティが設定されるテキストScreenshot: Text with text properties set

次の例は、FontStretch プロパティをプログラムで設定する方法を示しています。The following example shows how to set the FontStretch property programmatically.

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

注釈

この依存関係プロパティには、プロパティの使用法も添付されています。This dependency property also has an attached property usage. XAMLXAMLでは、オブジェクトは <object TextElement.FontStretch="value".../>になります。ここで、 objectTextElementに含まれるオブジェクト要素 (通常はフロー要素) であり、 valueFontStretch クラスの文字列形式のプロパティ名の1つです。In XAMLXAML, the usage is <object TextElement.FontStretch="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is one of the string-format property names of the FontStretch class. コードでは、添付プロパティの使用は GetFontStretch および SetFontStretch メソッドによってサポートされています。In code, the attached property usage is supported by the GetFontStretch and SetFontStretch methods. 添付プロパティの使用は一般的ではありません。 TextElement に含まれる可能性のあるほとんどの要素は、コンテンツホストがレンダリングに使用する類似の非添付 FontStretch プロパティをサポートしているためです。The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontStretch property, which the content host uses for rendering.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field FontStretchProperty
メタデータプロパティが true に設定されるMetadata properties set to true AffectsMeasureAffectsRenderInheritsAffectsMeasure, AffectsRender, Inherits

適用対象