TextDecoration.Pen TextDecoration.Pen TextDecoration.Pen TextDecoration.Pen Property

Definition

Ruft den Pen ab, der zum Zeichnen der Textdekoration verwendet wird, oder legt diesen fest.Gets or sets the Pen used to draw the text decoration.

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

Eigenschaftswert

Der zum Zeichnen der Textdekoration verwendete Pen.The Pen used to draw the text decoration. Wenn dieser Wert nullist, entspricht die Dekorations Farbe dem Text, auf den Sie angewendet wird, und die Stärke der Dekoration ist auf die empfohlene Stärke der Schriftart festgelegt.If this value is null, the decoration color matches the text to which it is applied and the decoration's thickness is set to the font's recommended thickness.

Beispiele

Im folgenden Codebeispiel wird eine Unterstreichung der Text Dekoration mit einem linearen Farbverlaufs Pinsel für den gestrichelten Stift erstellt.In the following code example, an underline text decoration is created with a linear gradient brush for the dashed pen.

// Use a linear gradient pen for the underline text decoration.
private void SetLinearGradientUnderline()
{
    // Create an underline text decoration. Default is underline.
    TextDecoration myUnderline = new TextDecoration();

    // Create a linear gradient pen for the text decoration.
    Pen myPen = new Pen();
    myPen.Brush = new LinearGradientBrush(Colors.Yellow, Colors.Red, new Point(0, 0.5), new Point(1, 0.5));
    myPen.Brush.Opacity = 0.5;
    myPen.Thickness = 1.5;
    myPen.DashStyle = DashStyles.Dash;
    myUnderline.Pen = myPen;
    myUnderline.PenThicknessUnit = TextDecorationUnit.FontRecommended;

    // Set the underline decoration to a TextDecorationCollection and add it to the text block.
    TextDecorationCollection myCollection = new TextDecorationCollection();
    myCollection.Add(myUnderline);
    TextBlock3.TextDecorations = myCollection;
}
' Use a linear gradient pen for the underline text decoration.
Private Sub SetLinearGradientUnderline()
	' Create an underline text decoration. Default is underline.
	Dim myUnderline As New TextDecoration()

	' Create a linear gradient pen for the text decoration.
	Dim myPen As New Pen()
	myPen.Brush = New LinearGradientBrush(Colors.Yellow, Colors.Red, New Point(0, 0.5), New Point(1, 0.5))
	myPen.Brush.Opacity = 0.5
	myPen.Thickness = 1.5
	myPen.DashStyle = DashStyles.Dash
	myUnderline.Pen = myPen
	myUnderline.PenThicknessUnit = TextDecorationUnit.FontRecommended

	' Set the underline decoration to a TextDecorationCollection and add it to the text block.
	Dim myCollection As New TextDecorationCollection()
	myCollection.Add(myUnderline)
	TextBlock3.TextDecorations = myCollection
End Sub
<!-- Use a linear gradient pen for the underline text decoration. -->
<TextBlock FontSize="36">the lazy brown dog.
  <TextBlock.TextDecorations>
    <TextDecorationCollection>
      <TextDecoration  
        PenThicknessUnit="FontRecommended">
        <TextDecoration.Pen>
          <Pen Thickness="1.5">
            <Pen.Brush>
              <LinearGradientBrush Opacity="0.5"
                StartPoint="0,0.5"  EndPoint="1,0.5">
                <LinearGradientBrush.GradientStops>
                  <GradientStop Color="Yellow" Offset="0" />
                  <GradientStop Color="Red" Offset="1" />
                </LinearGradientBrush.GradientStops>
              </LinearGradientBrush>
            </Pen.Brush>
            <Pen.DashStyle>
              <DashStyle Dashes="2"/>
            </Pen.DashStyle>
          </Pen>
        </TextDecoration.Pen>
      </TextDecoration>
    </TextDecorationCollection>
  </TextBlock.TextDecorations>
</TextBlock>

Hinweise

Das folgende Beispiel zeigt eine Text Dekoration, die mit einem linearen Farbverlaufs Pinsel und einem gestrichelten Stift formatiert wurde.The following example shows a text decoration that has been styled with a linear gradient brush and a dashed pen.

Text Dekoration mit linearer Farbverlaufs UnterstreichungText decoration with linear gradient underline
Beispiel für eine Unterstreichung mit einem linearen Farbverlaufs Pinsel und einem gestrichelten StiftExample of an underline styled with a linear gradient brush and dashed pen

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field PenProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch