GetPath 函式 (wingdi.h)

GetPath函式會擷取定義線條端點的座標，以及選取至指定裝置內容之路徑中之曲線的控制點。

語法

int GetPath(
  [in]  HDC     hdc,
  [out] LPPOINT apt,
  [out] LPBYTE  aj,
  [in]  int     cpt
);

[in] hdc

包含已關閉路徑之裝置內容的控制碼。

[out] apt

以邏輯座標接收線條端點和曲線控制點之 POINT 結構的陣列指標。

[out] aj

接收頂點類型的位元組陣列指標。此參數可以是下列其中一個值。

類型	描述
PT_MOVETO	指定 lpPoints 參數中的對應點會啟動脫離的圖。
PT_LINETO	指定前一個點和 lpPoints 中對應的點是一行的端點。
PT_BEZIERTO	指定 lpPoints 中的對應點是 Bézier 曲線的控制點或結束點。 PT_BEZIERTO值一律發生在三個集合中。路徑正前面的點會定義 Bézier 曲線的起點。前兩個PT_BEZIERTO點是控制點，如果硬式編碼) 點，第三個PT_BEZIERTO點就是結束 (。

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

旗標	描述
PT_CLOSEFIGURE	指定在繪製對應的線條或曲線之後，圖會自動關閉。從線條或曲線端點將線條繪製到對應至最後一個PT_MOVETO點，即可關閉此圖。

[in] cpt

可以儲存在lpPoints所指向之陣列中的POINT結構總數。這個值必須與可以放在 lpTypes所指向陣列中的位元組數目相同。

如果 nSize 參數為非零，則傳回值為列舉的點數。如果 nSize 為 0，則傳回值是路徑中 (的點總數， 而 GetPath 會將任何點寫入緩衝區) 。如果 nSize 為非零，且小於路徑中的點數，則傳回值為 1。

hdc參數所識別的裝置內容必須包含封閉路徑。

路徑的點會以邏輯座標傳回。點會儲存在裝置座標的路徑中，因此 GetPath 會使用目前轉換的反轉，將裝置座標中的點變更為邏輯座標。

在GetPath將路徑中的所有曲線轉換成線條線段之前，可以呼叫FlattenPath函式。