PATHDATA 結構 (winddi.h)

  • 發行項

PATHDATA 結構描述子路徑的所有或部分。

語法

typedef struct _PATHDATA {
  FLONG    flags;
  ULONG    count;
  POINTFIX *pptfx;
} PATHDATA, *PPATHDATA;

成員

flags

描述傳回資料的旗標定義如下：

值 意義
PD_ALL 此旗標是此表格中其他旗標的 ORed 組合。 也就是說，PD_ALL == PD_BEGINSUBPATH |PD_ENDSUBPATH |PD_RESETSTYLE |PD_CLOSEFIGURE |PD_BEZIERS。
PD_BEGINSUBPATH 第一個點會開始新的子路徑。 它未連線到先前的子路徑。 如果未設定此旗標，要從此數據繪製之第一個曲線的起點是上一個呼叫中傳回的最後一個點。
PD_BEZIERS 如果設定，針對此呼叫傳回的每一組三個控制點都會描述 Bezier 曲線。 如果清楚，每個控制點都會描述線條線段。 任一類型的起點在子路徑的開頭是明確的，或隱含為上一個曲線的端點。
PD_CLOSEFIGURE 只有在記錄結束子路徑時，才會定義這個位。 如果設定，則會有隱含的線條線段，連接子路徑的最後一個點與第一個點。 如果這類封閉式子路徑正在進行筆觸，則會在路徑周圍使用聯結，而且沒有結束上限。 如果未設定此旗標，則會將子路徑視為開啟，即使第一個和最後一個點發生一致也一樣。 在此情況下，應該繪製結束端點。 此旗標與填滿無關，因為填滿路徑時會假設關閉所有子路徑。
PD_ENDSUBPATH 陣列的最後一個點會結束子路徑。 視PD_CLOSEFIGURE旗標而定，此子路徑可以開啟或關閉。 如果路徑中有更多數據要傳回，下一筆記錄就會開始新的子路徑。 請注意，單一記錄可能會開始和結束子路徑。
PD_RESETSTYLE 只有當此記錄開始新的子路徑時，才會定義這個位。 如果設定，表示樣式狀態應該在子路徑的開頭重設為零。 如果未設定，則樣式狀態是由 LINEATTRS 結構所定義，或從先前的子路徑繼續。

count

指定 pptfx 所指向的 POINTFIX 結構計數。

pptfx

POINTFIX 結構的數位指標，定義曲線的控制點。 這些結構不得修改。 如需 POINTFIX 結構的描述，請參閱 GDI 數據類型。

備註

PATHDATA 結構描述子路徑的所有或部分。 例如，路徑內的應用程式呼叫 MoveTo 會開始新的子路徑。

規格需求

需求 值
標頭 winddi.h (包括 Winddi.h)

另請參閱

LINEATTRS

PATHOBJ_bEnum