Freigeben über


ID2D1RenderTarget::D rawLine-Methode (d2d1.h)

Zeichnet eine Linie zwischen den angegebenen Punkten unter Verwendung des angegebenen Strichstils.

Syntax

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

Parameter

point0

Typ: D2D1_POINT_2F

Der Startpunkt der Linie in geräteunabhängigen Pixeln.

point1

Typ: D2D1_POINT_2F

Der Endpunkt der Linie in geräteunabhängigen Pixeln.

[in] brush

Typ: ID2D1Brush*

Der Pinsel, der zum Zeichnen des Strichs verwendet wird.

strokeWidth

Typ: FLOAT

Die Breite des Strichs in geräteunabhängigen Pixeln. Der Wert muss größer oder gleich 0,0f sein. Wenn dieser Parameter nicht angegeben ist, wird standardmäßig 1.0f angegeben. Der Strich wird auf der Linie zentriert.

[in, optional] strokeStyle

Typ: ID2D1StrokeStyle*

Der Stil des zu zeichnenden Strichs oder NULL zum Zeichnen einer durchgezogenen Linie.

Rückgabewert

Keine

Bemerkungen

Diese Methode gibt keinen Fehlercode zurück, wenn ein Fehler auftritt. Um zu ermitteln, ob bei einem Zeichnungsvorgang (z. B . DrawLine) ein Fehler aufgetreten ist, überprüfen Sie das ergebnis, das von den Methoden ID2D1RenderTarget::EndDraw oder ID2D1RenderTarget::Flush zurückgegeben wird.

Beispiele

Im folgenden Beispiel wird die DrawLine-Methode verwendet, um ein Raster zu erstellen, das die Breite und Höhe des Renderziels überspannt. Die Informationen zur Breite und Höhe werden von der rtSize-Variablen bereitgestellt.

        // 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
                );
        }

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1RenderTarget