PolyDraw 函式 （wingdi.h）

PolyDraw 函式會繪製一組折線段和貝氏曲線。

語法

BOOL PolyDraw(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const BYTE  *aj,
  [in] int         cpt
);

參數

[in] hdc

裝置內容的句柄。

[in] apt

POINT 結構的指標，其中包含每個線段的端點，以及邏輯單元中每個 Bézier 曲線的端點和控制點。

[in] aj

陣列的指標，指定如何使用 lppt 陣列中的每個點。 此參數可以是下列其中一個值。

類型	意義
PT_MOVETO	指定這個點會啟動脫離的圖形。 這個點會變成新的目前位置。
PT_LINETO	指定要從目前位置繪製到這個點的線條，然後變成新的目前位置。
PT_BEZIERTO	指定這個點是貝氏曲線的控制點或結束點。 PT_BEZIERTO類型一律會在三組中發生。 目前的位置會定義貝氏曲線的起點。 前兩個PT_BEZIERTO點是控制點，第三個PT_BEZIERTO點是終點。 結束點會變成新的目前位置。 如果沒有連續三個PT_BEZIERTO點，則會產生錯誤。

 

PT_LINETO或PT_BEZIERTO型別可以使用位運算符 OR 來結合下列值，以指出對應的點是圖的最後一個點，而且圖表已關閉。

價值	意義
PT_CLOSEFIGURE	指定在完成此點的PT_LINETO或PT_BEZIERTO類型之後，圖表會自動關閉。 從這個點繪製到最新的PT_MOVETO或 MoveToEx 點。 這個值會與線條的PT_LINETO型別或 Bézier 曲線結束點的PT_BEZIERTO類型結合，方法是使用位運算符 OR。 目前的位置會設定為結束線的結束點。

[in] cpt

lppt 陣列中的點總數，與 lpbTypes 陣列中的位元組數目相同。

傳回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。

言論

PolyDraw 函式可用來取代連續 呼叫 moveToEx、LineTo，以及 PolyBezierTo 函式來繪製脫離的數位。 線條和曲線是使用目前的畫筆繪製，而且圖形不會填滿。 如果呼叫 beginPath開始使用中路徑，PolyDraw 會新增至路徑。

包含在 lppt 陣列和 lpbTypes 陣列中的點會指出每個點是否為 moveTo、LineTo或 PolyBezierTo 作業的 一部分。 您也可以關閉數位。

此函式會更新目前的位置。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wingdi.h （包括 Windows.h）
連結庫	Gdi32.lib
DLL	Gdi32.dll

另請參閱

BeginPath

EndPath

線條和曲線函式

LineTo

線條和曲線概觀

MoveToEx

POINT

PolyBezierTo

PolyLine