Метод ID2D1RenderTarget::D rawLine (d2d1.h)

Статья
02/28/2024

Рисует линию между указанными точками с помощью заданного стиля штриха.

Синтаксис

void DrawLine(
                 D2D1_POINT_2F    point0,
                 D2D1_POINT_2F    point1,
  [in]           ID2D1Brush       *brush,
                 FLOAT            strokeWidth,
  [in, optional] ID2D1StrokeStyle *strokeStyle
);

Параметры

point0

Тип: D2D1_POINT_2F

Начальная точка линии в независимых от устройства пикселях.

point1

Тип: D2D1_POINT_2F

Конечная точка линии в независимых от устройства пикселях.

[in] brush

Тип: ID2D1Brush*

Кисть, используемая для рисования штриха линии.

strokeWidth

Тип: FLOAT

Ширина росчерка в независимых от устройства пикселях. Значение должно быть больше или равно 0,0f. Если этот параметр не указан, по умолчанию используется значение 1.0f. Штрих находится в центре линии.

[in, optional] strokeStyle

Тип: ID2D1StrokeStyle*

Стиль штриха для рисования или NULL для рисования сплошной линии.

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

None

Remarks

Этот метод не возвращает код ошибки в случае сбоя. Чтобы определить, завершилась ли операция рисования (например, DrawLine), проверка результат, возвращаемый методами ID2D1RenderTarget::EndDraw или ID2D1RenderTarget::Flush.

Примеры

В следующем примере метод DrawLine используется для создания сетки, охватывающей ширину и высоту целевого объекта отрисовки. Сведения о ширине и высоте предоставляются переменной rtSize .

        // Draw a grid background.
        int width = static_cast<int>(rtSize.width);
        int height = static_cast<int>(rtSize.height);

        for (int x = 0; x < width; x += 10)
        {
            m_pRenderTarget->DrawLine(
                D2D1::Point2F(static_cast<FLOAT>(x), 0.0f),
                D2D1::Point2F(static_cast<FLOAT>(x), rtSize.height),
                m_pLightSlateGrayBrush,
                0.5f
                );
        }

        for (int y = 0; y < height; y += 10)
        {
            m_pRenderTarget->DrawLine(
                D2D1::Point2F(0.0f, static_cast<FLOAT>(y)),
                D2D1::Point2F(rtSize.width, static_cast<FLOAT>(y)),
                m_pLightSlateGrayBrush,
                0.5f
                );
        }

Требования

Требование	Значение
Минимальная версия клиента	Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1.h
Библиотека	D2d1.lib
DLL	D2d1.dll

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

ID2D1RenderTarget

Поделиться через