Pen：：GetDashPattern 方法 (gdipluspen.h)

项目
08/24/2023

Pen：：GetDashPattern 方法获取当前为此 Pen 对象设置的自定义短划线和空格的数组。

语法

Status GetDashPattern(
  [out] REAL *dashArray,
  [in]  INT  count
);

parameters

[out] dashArray

类型： REAL*

指向数组的指针，该数组接收自定义虚线中的短划线和空格的长度。

[in] count

类型： INT

指定 dashArray 数组中的元素数的整数。

返回值

类型：状态

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

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

注解

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

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

示例

以下示例创建实数数组和 Pen 对象，设置短划线模式，并绘制自定义虚线。然后，代码获取当前为笔设置的短划线图案。

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

   // Create a custom dashed pen, and use it to draw a line.
   REAL dashVals[4] = {5, 2, 15, 4};
   Pen pen(Color(255, 0, 0, 0), 5);
   pen.SetDashPattern(dashVals, 4);
   graphics.DrawLine(&pen, 5, 20, 405, 200);

   // Obtain information about the pen.
   INT count = 0;
   REAL* dashValues = NULL;

   count = pen.GetDashPatternCount();
   dashValues = new REAL[count];
   pen.GetDashPattern(dashValues, count);

   for(INT j = 0; j < count; ++j)
   {
      // Inspect or use the value in dashValues[j].
   }
   delete [] dashValues;
}

要求


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