TextDecorations TextDecorations TextDecorations TextDecorations Class

定義

一連の定義済みの静的な文字装飾を提供します。Provides a set of static predefined text decorations.

public ref class TextDecorations abstract sealed
public static class TextDecorations
type TextDecorations = class
Public Class TextDecorations
継承
TextDecorationsTextDecorationsTextDecorationsTextDecorations

次の例では、取り消し線の文字の装飾で既定のフォント値が使用されています。In the following example, a strikethrough text decoration uses the default font value.

// Use the default font values for the strikethrough text decoration.
private void SetDefaultStrikethrough()
{
    // Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough;
}
' Use the default font values for the strikethrough text decoration.
Private Sub SetDefaultStrikethrough()
    ' Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough
End Sub
<!-- Use the default font values for the strikethrough text decoration. -->
<TextBlock
  TextDecorations="Strikethrough"
  FontSize="36" >
  The quick red fox
</TextBlock>

同じテキストに対して複数の文字装飾を指定することもできます。You can also specify multiple text decorations for the same text. 次の例では、同じテキストに下線と前線の文字の装飾が使用されています。In the following example, an underline and overline text decoration are used for the same text.

<!-- Use both an underline and overline text decoration for the same text. -->
<TextBlock TextDecorations="Underline, Overline">
  The quick red fox
</TextBlock>

文字列値 "None" を使用して、 TextDecorationsコレクション内に文字装飾がないことを示すことができます。You can use the string value "None" to indicate that there are no text decorations in the TextDecorations collection. 次の例では、 TextDecorationsコレクションは "None" に設定されています。In the following example, the TextDecorations collection is set to "None".

<!-- Set the text decoration collection to None to indicate no decorations. -->
<TextBlock TextDecorations="None">
  The quick red fox
</TextBlock>

メソッドを使用すると、 Clearテキストからすべての文字装飾を削除できます。You can remove all text decorations from text by using the Clear method. 次の例では、 TextDecorationsコレクションがクリアされています。In the following example, the TextDecorations collection is cleared.

TextBlock2.TextDecorations.Clear();
TextBlock2.TextDecorations.Clear()

既定ではHyperlink 、はTextDecorationオブジェクトを使用して下線を表示します。By default, Hyperlink uses a TextDecoration object to display an underline. 次のマークアップサンプルはHyperlink 、下線付きで定義されているを示しています。The following markup sample shows a Hyperlink defined with and without an underline:

<!-- Hyperlink with default underline. -->
<Hyperlink NavigateUri="http://www.msn.com">
  MSN Home
</Hyperlink>

<Run Text=" | " />

<!-- Hyperlink with no underline. -->
<Hyperlink Name="myHyperlink" TextDecorations="None"
           MouseEnter="OnMouseEnter"
           MouseLeave="OnMouseLeave"
           NavigateUri="http://www.msn.com">
  My MSN
</Hyperlink>

TextDecoration特にオブジェクトが多数Hyperlinkある場合は、オブジェクトをインスタンス化する際にパフォーマンスが高くなることがあります。TextDecoration objects can be performance intensive to instantiate, particularly if you have many Hyperlink objects. 詳細については、「方法 :ハイパーリンクに下線を設定するかどうかを指定します。For more information, see How to: Specify Whether a Hyperlink is Underlined.

注釈

文字装飾には、ベースライン、前線、取り消し線、下線の4種類があります。There are four types of text decorations: baseline, overline, strikethrough, and underline. 次の例は、テキストに対して相対的な文字装飾の位置を示しています。The following example shows the locations of the text decorations relative to the text.

文字装飾の位置の図Diagram of text decoration locations
文字装飾の種類の例Example of text decoration types

XAML 属性の使用方法XAML Attribute Usage

<object textDecorationsProperty="textDecorationType[,textDecorationType]"/>  

XAML 値XAML Values

textDecorationType
文字装飾BaselineUnderline種類OverLine(、、、または)。 StrikethroughThe type of text decoration: Baseline, OverLine, Strikethrough, or Underline. 複数の装飾が許可されており、値はコンマで区切られています。More than one decoration is permitted, with values separated by commas. "None" を指定して、文字装飾の種類を指定することもできます。You can also specify "None" to indicate no type of text decoration.

プロパティ

Baseline Baseline Baseline Baseline

ベースラインの TextDecoration を指定します。Specifies a baseline TextDecoration.

OverLine OverLine OverLine OverLine

上線の TextDecoration を指定します。Specifies an overline TextDecoration.

Strikethrough Strikethrough Strikethrough Strikethrough

取り消し線の TextDecoration を指定します。Specifies a strikethrough TextDecoration.

Underline Underline Underline Underline

下線の TextDecoration を指定します。Specifies an underline TextDecoration.

適用対象