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
| 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 |