Метод Pen::SetDashPattern (gdipluspen.h)

Статья
08/24/2023

Метод Pen::SetDashPattern задает массив настраиваемых дефисов и пробелов для этого объекта Pen .

Синтаксис

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

Параметры

[in] dashArray

Тип: const REAL*

Указатель на массив реальных чисел, указывающий длину настраиваемых дефисов и пробелов. Все элементы в массиве должны быть положительными реальными числами.

[in] count

Тип: INT

Целое число, указывающее количество элементов в массиве dashArray . Целое число должно быть больше 0, а не больше общего числа элементов в массиве.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Элементы в массиве dashArray задают длину каждого дефиса и пробел в шаблоне дефиса. Первый элемент задает длину дефиса, второй — длину пробела, третий — длину дефиса и т. д.

Длина каждого дефиса и пробела в шаблоне дефиса представляет собой произведение значения элемента в массиве и ширину объекта 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
Header	gdipluspen.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll