Método ID2D1RenderTarget::D rawLine (d2d1.h)

Dibuja una línea entre los puntos especificados con el estilo de trazo especificado.

Sintaxis

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

Parámetros

point0

Tipo: D2D1_POINT_2F

El punto inicial de la línea, en píxeles independientes del dispositivo.

point1

Tipo: D2D1_POINT_2F

El punto final de la línea, en píxeles independientes del dispositivo.

[in] brush

Tipo: ID2D1Brush*

El pincel usado para pintar el trazo de la línea.

strokeWidth

Tipo: FLOAT

Ancho del trazo, en píxeles independientes del dispositivo. El valor debe ser mayor o igual que 0,0f. Si no se especifica este parámetro, el valor predeterminado es 1.0f. El trazo se centra en la línea.

[in, optional] strokeStyle

Tipo: ID2D1StrokeStyle*

Estilo de trazo que se va a pintar o NULL para pintar una línea sólida.

Valor devuelto

None

Observaciones

Este método no devuelve un código de error si se produce un error. Para determinar si se produjo un error en una operación de dibujo (como DrawLine), compruebe el resultado devuelto por los métodos ID2D1RenderTarget::EndDraw o ID2D1RenderTarget::Flush .

Ejemplos

En el ejemplo siguiente se usa el método DrawLine para crear una cuadrícula que abarque el ancho y el alto del destino de representación. La variable rtSize proporciona la información de ancho y alto.

        // 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
                );
        }

Requisitos

Consulte también

ID2D1RenderTarget