Pen::SetDashStyle 方法 (gdipluspen.h)

Pen::SetDashStyle 方法设置此 Pen 对象的短划线样式。

语法

Status SetDashStyle(
  [in] DashStyle dashStyle
);

参数

[in] dashStyle

类型: DashStyle

指定此 Pen 对象的短划线样式的 DashStyle 枚举的元素。

返回值

类型: 状态

如果方法成功,则返回 Ok,这是 Status 枚举的元素。

如果 方法失败,它将返回 Status 枚举的其他元素之一。

注解

虚线中的短划线长度取决于短划线样式和 Pen 对象的宽度。 分隔虚线中两个短划线的空间长度等于 Pen 对象的宽度。

示例

以下示例创建 一个 Pen 对象,设置短划线样式,并绘制一条线条。 然后,代码重置短划线样式,绘制第二行,再次重置短划线样式,并绘制第三行。

VOID Example_SetDashStyle(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen pen(Color(255, 0, 0, 255), 15);

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

要求

要求
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdipluspen.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

绘制自定义虚线

Pen::GetDashCap

Pen::GetDashOffset

Pen::GetDashPattern

Pen::GetDashPatternCount

Pen::GetDashStyle

Pen::SetDashCap

Pen::SetDashOffset

Pen::SetDashPattern

笔、线条和矩形