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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1.h
程式庫	D2d1.lib
Dll	D2d1.dll

另請參閱

ID2D1RenderTarget