Compartilhar via


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

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1RenderTarget