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

Метод Pen::SetDashCap задает стиль тире для этого объекта Pen .

Синтаксис

Status SetDashCap(
  [in] DashCap dashCap
);

Параметры

[in] dashCap

Тип: DashCap

Элемент перечисления DashCap , указывающий тире для этого объекта Pen .

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

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

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

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

Комментарии

Если для объекта Pen задано выравнивание PenAlignmentInset, вы не сможете использовать это перо для рисования треугольных тире.

Примеры

В следующем примере создается объект Pen , задается стиль тире и крышка тире, а также рисуется пунктирная линия.

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

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

   // Set the dash style for the pen.
   pen.SetDashStyle(DashStyleDash);

   // Set a triangular dash cap for the pen.
   pen.SetDashCap(DashCapTriangle);

   // Draw a line using the pen.
   graphics.DrawLine(&pen, 20, 20, 200, 100);
}

Требования

Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdipluspen.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll

См. также раздел

Рисование пользовательской пунктирной линии

Рисование линии с помощью колпачка

Перо

Pen::GetCustomEndCap

Pen::GetCustomStartCap

Pen::GetDashCap

Перья, линии и прямоугольники