DashStyle.Dashes プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この 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, setPublic Property Dashes As 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 の既定値DashCapは Square. これにより、線の半分の太さのエンド キャップがペン ストロークの両端に追加されます。 (例については、次を参照してくださいPenLineCap)。したがって、配列 、および 2 乗DashCapを指定した場合、実際の0ダッシュの長さは () + ( * 0DashCap * 2Thickness) になります。 2
コレクション内に奇数の値がある場合、値は偶数の値を生成するために 1 回繰り返されたかのように解釈されます。 たとえば、,, を2``3含むコレクションは、5,3,,5``3``2``5, を含む2コレクションと同じように解釈されます。
配列内の負の値は、その絶対値として解釈されます。
依存プロパティ情報
| 識別子フィールド | DashesProperty |
メタデータのプロパティが次に設定されている true |
なし |