Метод Pen::SetDashStyle (gdipluspen.h)
Метод Pen::SetDashStyle задает стиль тире для этого объекта Pen .
Синтаксис
Status SetDashStyle(
[in] DashStyle dashStyle
);
Параметры
[in] dashStyle
Тип: DashStyle
Элемент перечисления DashStyle , указывающий стиль тире для этого объекта Pen .
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Комментарии
Длина тире в пунктирной линии зависит от стиля тире и ширины объекта Pen . Длина пространства, разделяющего два дефиса в пунктирной линии, равна ширине объекта Pen .
Примеры
В следующем примере создается объект Pen , задается стиль дефиса и рисуется линия. Затем код сбрасывает стиль тире, рисует вторую линию, сбрасывает стиль тире и рисует третью линию.
VOID Example_SetDashStyle(HDC hdc)
{
Graphics graphics(hdc);
// Create a Pen object.
Pen pen(Color(255, 0, 0, 255), 15);
// Set the dash style for the pen, and draw a dashed line.
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 50, 400, 150);
// Reset the dash style for the pen, and draw a second line.
pen.SetDashStyle(DashStyleDot);
graphics.DrawLine(&pen, 0, 80, 400, 180);
// Reset the dash style for the pen, and draw a third line.
pen.SetDashStyle(DashStyleDashDot);
graphics.DrawLine(&pen, 0, 110, 400, 210);
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdipluspen.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |