DashStyle.Dashes DashStyle.Dashes DashStyle.Dashes DashStyle.Dashes Property

定義

この DashStyle の破線と空白のコレクションを取得または設定します。Gets or sets the collection of dashes and gaps in this 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

プロパティ値

破線と空白のコレクション。The collection of dashes and gaps. 既定値は空の DoubleCollection です。The default is an empty DoubleCollection.

次の例は、のDashStyleプロパティを使用して、 Pen [テキスト] の下に破線を作成する方法を示しています。The following example shows how to use the DashStyle property of a Pen to create a dashed line under text.

<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>

注釈

このコレクションは、交互のダッシュとギャップの長さを表します。This collection describes the length of alternating dashes and gaps. コレクション内の値は、 Thickness Penのの倍数で表現されます。The values in the collection are in terms of multiples of the Thickness of the Pen. たとえば、の1配列は、2長さのダッシュ (Thickness * 1) の後に length (2 * Thickness) のギャップを指定します。For example, an array of 1,2 specifies a dash of length (1 * Thickness) followed by a gap of length (2 * Thickness).

注意

描画される破線の実際の長さは、ダッシュの両端にDashCap追加されるのスタイルによって異なります。The actual length of the dash that is drawn depends on the style of DashCap that is added to each end of the dash. の既定DashCap値はSquareです。 PenThe default DashCap value for a Pen is Square. これにより、ペンストロークの各端に追加される線の太さの半分の端がキャップされます。This causes an end cap that is one half the thickness of the line to be added onto each end of the pen stroke. 例については、「PenLineCap」を参照してください。したがって、の0 * DashCap0 DashCap 2配列と二乗を指定すると、実際のダッシュの長さは ( * Thickness) + (2) になります。(See PenLineCap for an example.) Therefore, if you specify an array of 0, 2 and a square DashCap, the actual dash length will be (0 * Thickness) + (2 * DashCap).

コレクション内の値の数が奇数の場合、値は、偶数個の値を生成するために1回繰り返されたかのように解釈されます。If there are an odd number of values in the collection, the values are interpreted as if they had been repeated once to produce an even number of values. たとえば、、、を含む2``5``3 2``5 3コレクションは、、、、、、を含む2``3コレクションと同じように解釈されます。5For example, a collection containing 2,3,5 is interpreted the same as a collection containing 2,3,5,2,3,5.

配列内の負の値は、その絶対値として解釈されます。Negative values in the array are interpreted as their absolute value.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field DashesProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象