DashStyle.Dashes 屬性

定義

命名空間:

System.Windows.Media

組件:

PresentationCore.dll

取得或設定這個 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。

範例

下列範例示範如何使用 DashStyle 的 Pen 屬性，在文字下建立虛線。

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

備註

此集合描述交替虛線和間距的長度。 集合中的值會以 的 Thickness Pen 倍數表示。 例如，的 1 2 陣列會指定長度的虛線 ( * 1 Thickness) 後面接著長度 Thickness 2 * () 的間距。

注意

所繪製虛線的實際長度取決於新增至虛線每一端的 樣式 DashCap 。 的 Pen 預設值 DashCap 為 Square 。 這會導致在筆刷筆觸的每一端新增一半線條粗細的結束端點。 (See PenLineCap for an example.) 因此，如果您指定 的 0 2 陣列和正方形 DashCap ，實際的虛線長度將會 (0 * Thickness) + (2 * DashCap) 。

如果集合中有奇數的值，這些值會解譯為重複一次，以產生偶數的值。 例如，包含 2 的集合會 5 解譯為與包含 2 、 3 、 5 、、 2 的 5 3 集合 3 相同。

陣列中的負值會解譯為其絕對值。

相依性屬性資訊

識別碼欄位	DashesProperty
中繼資料屬性設定為 true	無