CDC::Chord

Artykuł
02/27/2013

Rysuje cięciwy (rysunek zamknięte przez przecięcie elipsy i segmentu linii).

BOOL Chord(
   int x1,
   int y1,
   int x2,
   int y2,
   int x3,
   int y3,
   int x4,
   int y4 
);
BOOL Chord(
   LPCRECT lpRect,
   POINT ptStart,
   POINT ptEnd 
);

Parametry

x1
Określa współrzędną x lewego górnego rogu prostokąta obwiedni cięciwy (w jednostkach logicznych).
y1
Określa współrzędną y lewego górnego rogu prostokąta obwiedni cięciwy (w jednostkach logicznych).
x2
Określa współrzędną x w prawym dolnym rogu prostokąta obwiedni cięciwy (w jednostkach logicznych).
y2
Określa współrzędną y dolnym rogu prostokąta obwiedni cięciwy (w jednostkach logicznych).
x 3
Określa współrzędną x punktu, który definiuje cięciwy na początkowy (w jednostkach logicznych).
y3
Określa współrzędną y punktu, który definiuje cięciwy na początkowy (w jednostkach logicznych).
x4
Określa współrzędną x punktu, który definiuje cięciwy końcowy (w jednostkach logicznych).
y4
Określa współrzędną y punktu, który definiuje cięciwy końcowy (w jednostkach logicznych).
lpRect
Określa prostokąta obwiedni (w jednostkach logicznych).Można przekazywać albo LPRECT lub CRect obiektu dla tego parametru.
ptStart
Określa, że - współrzędnych x i y-punktu, który definiuje cięciwy na początkowy (w jednostkach logicznych).Ten punkt nie musi znajdować się dokładnie na akord.Można przekazywać albo punkt struktury lub CPoint obiektu dla tego parametru.
ptEnd
Określa - współrzędnych x i y-punkt definiujący cięciwy punkt końcowy (w jednostkach logicznych).Ten punkt nie musi znajdować się dokładnie na akord.Można przekazywać albo punkt struktury lub CPoint obiektu dla tego parametru.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

(x1, y1) I (x2, y2) parametry określają narożniki lewym górnym i dolnym odpowiednio prostokąta obwiedni elipsy, który jest częścią cięciwy.(X 3, y3) i (x4, y4) parametry określić punkty końcowe linii przecinającej elipsy.Akord jest rysowane za pomocą wybranego pióra i wypełnione przy użyciu pędzla.

Rysunek przez Chord rozciąga się do funkcji, ale nie ma współrzędne prawej i dolnej.Oznacza to, że wysokość rysunku jest y2 — y1 i szerokości rysunku jest x2 — x1.

Przykład

void CDCView::DrawChord(CDC* pDC)
{
   // Fill the client area with a circle. The circle is
   // blue and filled with blue, but has a chord cut out
   // of it from 3 o'clock to 6 o'clock. That chord is
   // red and filled with a red diagonal hatch.

   // Get the client area.
   CRect rectClient;
   GetClientRect(rectClient);

   // Make a couple of pens and similar brushes.
   CPen penBlue, penRed;
   CBrush brushBlue, brushRed;
   CBrush* pOldBrush;
   CPen* pOldPen;

   brushBlue.CreateSolidBrush(RGB(0, 0, 255));
   brushRed.CreateHatchBrush(HS_FDIAGONAL, RGB(255, 0, 0));
   penBlue.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(0, 0, 255));
   penRed.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(255, 0, 0));

   // Draw from 3 o'clock to 6 o'clock, counterclockwise,
   // in a blue pen with a solid blue fill.
   pOldPen = pDC->SelectObject(&penBlue);
   pOldBrush = pDC->SelectObject(&brushBlue);

   pDC->Chord(rectClient,
      CPoint(rectClient.right, rectClient.CenterPoint().y),
      CPoint(rectClient.CenterPoint().x, rectClient.right));

   // Draw the remaining quarter chord from 6 o'clock
   // to 3 o'clock, counterclockwise, in a red pen
   // with the hatched brush.
   pDC->SelectObject(&penRed);
   pDC->SelectObject(&brushRed);

   // Keep the same parameters, but reverse start and
   // end points.
   pDC->Chord(rectClient,
      CPoint(rectClient.CenterPoint().x, rectClient.right),
      CPoint(rectClient.right, rectClient.CenterPoint().y));

   // Restore the previous pen.
   pDC->SelectObject(pOldPen);
}