TextElement.FontWeight プロパティ

定義

要素のコンテンツの、最上位レベルのフォントの太さを取得または設定します。Gets or sets the top-level font weight for the content of the element.

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

プロパティ値

使用するフォントの太さを指定する FontWeights クラスのメンバー。A member of the FontWeights class that specifies the desired font weight. 既定値は、MessageFontWeight 値によって決まります。The default value is determined by the MessageFontWeight value.

次の例では、Paragraph を例の要素として使用して、FontWeight 属性を設定する方法を示します。The following example shows how to set the FontWeight 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

次の例は、FontWeight プロパティをプログラムで設定する方法を示しています。The following example shows how to set the FontWeight 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.FontWeight="value".../>になります。ここで、 objectTextElementに含まれるオブジェクト要素 (通常はフロー要素) であり、 valueFontWeight 列挙型の文字列形式の値の1つです。In XAMLXAML, the usage is <object TextElement.FontWeight="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is one of the string-format values of the FontWeight enumeration. コードでは、添付プロパティの使用は GetFontWeight および SetFontWeight メソッドによってサポートされています。In code, the attached property usage is supported by the GetFontWeight and SetFontWeight methods. 添付プロパティの使用は一般的ではありません。 TextElement に含まれる可能性のあるほとんどの要素は、コンテンツホストがレンダリングに使用する類似の非添付 FontWeight プロパティをサポートしているためです。The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontWeight property, which the content host uses for rendering.

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

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

適用対象