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

Статья
08/24/2023

Метод Pen::GetDashPattern получает массив пользовательских дефисов и пробелов, заданных в данный момент для этого объекта Pen .

Синтаксис

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

Параметры

[out] dashArray

Тип: REAL*

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

[in] count

Тип: INT

Целое число, указывающее количество элементов в массиве dashArray .

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

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

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