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数组指定长度 () Thickness * 1的短划线，后跟长度 (Thickness2 * ) 。
注意
绘制的短划线的实际长度取决于添加到短划线每一端的 样式 DashCap 。 的Pen默认值DashCap为 Square。 这会导致将线条粗细的一半的端帽添加到笔划的每一端。 (see PenLineCap for a example.) 因此，如果指定 一个 数组02和一个正方形 DashCap，则实际短划线长度将 (0 * Thickness) + (2 * DashCap) 。
如果集合中有奇数的值，则这些值将解释为重复一次，以生成偶数值。 例如，包含 2的53集合的解释与包含 2、3、、25、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) |
