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

Artículo
08/22/2023

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

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1.h
Library	D2d1.lib
Archivo DLL	D2d1.dll

Consulte también

ID2D1RenderTarget

Share via