Metodo ID2D1RenderTarget::D rawLine (d2d1.h)

Disegna una linea tra i punti specificati usando lo stile del tratto specificato.

Sintassi

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

Parametri

point0

Tipo: D2D1_POINT_2F

Punto iniziale della riga, in pixel indipendenti dal dispositivo.

point1

Tipo: D2D1_POINT_2F

Punto finale della linea, in pixel indipendenti dal dispositivo.

[in] brush

Tipo: ID2D1Brush*

Pennello usato per disegnare il tratto della linea.

strokeWidth

Tipo: FLOAT

Larghezza del tratto, in pixel indipendenti dal dispositivo. Il valore deve essere maggiore o uguale a 0,0f. Se questo parametro non è specificato, il valore predefinito è 1.0f. Il tratto è centrato sulla linea.

[in, optional] strokeStyle

Tipo: ID2D1StrokeStyle*

Stile di tratto da disegnare o NULL per disegnare una linea solida.

Valore restituito

nessuno

Osservazioni

Questo metodo non restituisce un codice di errore se ha esito negativo. Per determinare se un'operazione di disegno (ad esempio DrawLine) non è riuscita, controllare il risultato restituito dai metodi ID2D1RenderTarget::EndDraw o ID2D1RenderTarget::Flush.

Esempio

Nell'esempio seguente viene usato il metodo DrawLine per creare una griglia che estende la larghezza e l'altezza della destinazione di rendering. Le informazioni sulla larghezza e sull'altezza vengono fornite dalla variabile 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
                );
        }

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1.h
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1RenderTarget