Pen：：SetDashOffset 方法 (gdipluspen.h)

项目
02/26/2024

Pen：：SetDashOffset 方法设置从虚线开始到虚线中第一个短划线起点的距离。

语法

Status SetDashOffset(
  [in] REAL dashOffset
);

参数

[in] dashOffset

类型： REAL

指定虚线中空格的移动次数的实数。每次移位等于虚线中空格的长度。

返回值

类型：状态

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

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

注解

正 短划线Offset 值沿路径向前移动第一个短划线，负 短划线Offset 值将路径的开头沿第一个短划线向前移动。

示例

以下示例创建一个 Pen 对象，设置短划线样式，并绘制一条线。然后，代码设置笔的偏移值并绘制第二行。

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

   // Create a Pen object, set the dash style, and draw a line.
   Pen pen(Color(255, 0, 0, 255), 15);
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 50);

   // Set the dash offset value for the pen, and draw a second line.
   pen.SetDashOffset(10);
   graphics.DrawLine(&pen, 0, 80, 400, 80);
}

要求

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