ID2D1RenderTarget：:D rawLine 方法 (d2d1.h)

使用指定的笔划样式在两个指定的点之间绘制一条线。

语法

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 样式。

返回值

无

备注

如果此方法失败，此方法不会返回错误代码。 若要确定绘图操作 (（如 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、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1.h
Library	D2d1.lib
DLL	D2d1.dll

另请参阅

ID2D1RenderTarget