Pen：：SetDashPattern 方法 (gdipluspen.h)

项目
08/24/2023

Pen：：SetDashPattern 方法为此 Pen 对象设置自定义短划线和空格的数组。

语法

Status SetDashPattern(
  [in] const REAL *dashArray,
  [in] INT        count
);

parameters

[in] dashArray

类型： const REAL*

指向实数数组的指针，该数组指定自定义短划线和空格的长度。数组中的所有元素都必须是正实数。

[in] count

类型： INT

指定 dashArray 数组中的元素数的整数。整数必须大于 0 且不大于数组中的元素总数。

返回值

类型：状态

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

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

注解

此方法将此 Pen 对象的 DashStyle 枚举设置为 DashStyleCustom。

dashArray 数组中的元素设置短划线模式中每个短划线和空格的长度。第一个元素设置短划线的长度，第二个元素设置空格的长度，第三个元素设置短划线的长度，依此类推。

短划线模式中每个短划线和空格的长度是数组中元素值的乘积和 Pen 对象的宽度。

示例

以下示例创建实数数组。然后，代码创建一个 Pen 对象，根据数组设置短划线图案，然后绘制自定义虚线。

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

   // Create and set an array of real numbers.
   REAL dashVals[4] = {
      5.0f,   // dash length 5
      2.0f,   // space length 2
      15.0f,  // dash length 15
      4.0f};  // space length 4

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

   // Set the dash pattern for the custom dashed line.
   pen.SetDashPattern(dashVals, 4);

   // Draw the custom dashed line.
   graphics.DrawLine(&pen, 5, 20, 405, 200); 
}

要求


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