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