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

Desenha uma linha entre os pontos especificados usando o estilo de traço especificado.

Sintaxe

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

O ponto de partida da linha, em pixels independentes do dispositivo.

point1

Tipo: D2D1_POINT_2F

O ponto final da linha, em pixels independentes do dispositivo.

[in] brush

Tipo: ID2D1Brush*

O pincel usado para pintar o traço da linha.

strokeWidth

Tipo: FLOAT

A largura do traço, em pixels independentes do dispositivo. O valor deve ser maior ou igual a 0,0f. Se esse parâmetro não for especificado, o padrão será 1.0f. O traço está centralizado na linha.

[in, optional] strokeStyle

Tipo: ID2D1StrokeStyle*

O estilo de traço a ser pintado ou NULL para pintar uma linha sólida.

Retornar valor

Nenhum

Comentários

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como DrawLine) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Exemplos

O exemplo a seguir usa o método DrawLine para criar uma grade que abrange a largura e a altura do destino de renderização. As informações de largura e altura são fornecidas pela variável 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
                );
        }

Requisitos

Confira também

ID2D1RenderTarget