DashStyle 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示虛線和間距的序列，將由 Pen 套用。
public ref class DashStyle sealed : System::Windows::Media::Animation::Animatable[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public sealed class DashStyle : System.Windows.Media.Animation.Animatable[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type DashStyle = class
inherit Animatable
interface DUCE.IResource[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type DashStyle = class
inherit AnimatablePublic NotInheritable Class DashStyle
Inherits Animatable- 繼承
- 屬性
範例
下列範例示範如何使用 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>
下圖顯示上述範例所產生的內容。
下圖顯示套用至底線的不同虛線樣式範例。
備註
Dashes這個類別的 屬性描述交替虛線和間距的長度。 集合中的值以 的倍數 ThicknessPen 表示。 例如，的 12 陣列會指定長度的虛線 () * 1Thickness 後面接著長度的間距 (Thickness2 * ) 。
注意
所繪製虛線的實際長度取決於新增至虛線每一端的 樣式 DashCap 。 的 Pen 預設值 DashCap 為 Square 。 這會導致一半線條的粗細加到筆刷筆觸的每個結尾。 (如需 PenLineCap example.) ，因此，如果您指定 的 02 陣列，則 DashCap 實際的虛線長度將會 () Thickness * 0 + () 。 2 * DashCap
如果集合中有奇數的值，這些值會解譯成已重複一次，以產生偶數的值。 例如，包含 2 、 3 的 5 集合會解譯為與包含 2 、 3 、 5 、 2 、、 3 的 5 集合相同。
陣列中的負值會解譯為其絕對值。
建構函式
| DashStyle() |
初始化 DashStyle 類別的新執行個體。 |
| DashStyle(IEnumerable<Double>, Double) |
欄位
| DashesProperty |
識別 Dashes 相依性屬性。 |
| OffsetProperty |
識別 Offset 相依性屬性。 |
屬性
| CanFreeze |
取得值，指出是否可以將物件設為不可修改。 (繼承來源 Freezable) |
| Dashes |
取得或設定這個 DashStyle 中的虛線和間距的集合。 |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實例 CLR 型別的 。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| HasAnimatedProperties |
取得值，這個值表示是否有一個或多個 AnimationClock 物件與這個物件的任何一個相依性屬性相關聯。 (繼承來源 Animatable) |
| IsFrozen |
取得值，該值表示物件目前是否可修改。 (繼承來源 Freezable) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| Offset |
取得或設定在虛線序列中開始描邊的位置。 |
方法
事件
| Changed |
發生於 Freezable 或所含的物件遭到修改時。 (繼承來源 Freezable) |
