次の方法で共有


DashStyle.Dashes プロパティ

定義

この DashStyle の破線と空白のコレクションを取得または設定します。

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

プロパティ値

DoubleCollection

破線と空白のコレクション。 既定値は空の DoubleCollection です。

次の例は、a Pen のプロパティをDashStyle使用して、テキストの下に破線を作成する方法を示しています。

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
  <StackPanel Margin="20">

    <TextBlock FontSize="36">
      the lazy brown dog.
      <TextBlock.TextDecorations>
        <TextDecoration Location="Underline"  
          PenThicknessUnit="FontRecommended">
          <TextDecoration.Pen>
            <Pen Thickness="1.5" Brush="Red" >

              <!-- For the underline, create a dashed line with each
                   dash twice the thickness of the Pen and each gap 8 times
                   the thickness of the Pen. -->
              <Pen.DashStyle>
                <DashStyle Dashes="2,8"/>
              </Pen.DashStyle>
            </Pen>
          </TextDecoration.Pen>
        </TextDecoration>
      </TextBlock.TextDecorations>
    </TextBlock>
  </StackPanel>
</Page>

注釈

このコレクションでは、交番ダッシュとギャップの長さを説明します。 コレクション内の値は、ThicknessPen. たとえば、配列の長さ (Thickness1 * ) のダッシュを指定し、その後に長さのギャップ (Thickness2 * ) を指定します。2 1

注意

描画されるダッシュの実際の長さは、ダッシュの DashCap 各端に追加されるスタイルによって異なります。 a Pen の既定値DashCapSquare. これにより、線の半分の太さのエンド キャップがペン ストロークの両端に追加されます。 (例については、次を参照してくださいPenLineCap)。したがって、配列 、および 2 乗DashCapを指定した場合、実際の0ダッシュの長さは () + ( * 0DashCap * 2Thickness) になります。 2

コレクション内に奇数の値がある場合、値は偶数の値を生成するために 1 回繰り返されたかのように解釈されます。 たとえば、,, を2``3含むコレクションは、5,3,,5``3``2``5, を含む2コレクションと同じように解釈されます。

配列内の負の値は、その絶対値として解釈されます。

依存プロパティ情報

識別子フィールド DashesProperty
メタデータのプロパティが次に設定されている true なし

適用対象