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 ist null, entspricht die Dekorationsfarbe den Text, der auf das er angewendet wird, und die Stärke der Dekoration je nastaven für der Schriftart empfohlene Stärke.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

Das folgende Codebeispiel zeigt wird ein "Unterstreichen" Text-Decoration mit einem linearen Farbverlaufspinsel für den Stift gestrichelte 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 einen Text-Decoration, die mit einem linearen Farbverlaufspinsel und ein gestrichelten Stift formatiert wurde.The following example shows a text decoration that has been styled with a linear gradient brush and a dashed pen.

Textergänzung mit linearer farbverlaufsunterstreichungText decoration with linear gradient underline
Beispiel für eine Unterstreichung formatiert mit einem linearen Farbverlauf Pinsel und gestrichelten StiftExample of an underline styled with a linear gradient brush and dashed pen

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field PenProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für:

Siehe auch