Pen：：SetCompoundArray 方法 (gdipluspen.h)

Pen：：SetCompoundArray方法會設定這個Pen物件的複合陣列。

語法

Status SetCompoundArray(
  [in] const REAL *compoundArray,
  [in] INT        count
);

參數

[in] compoundArray

類型： const REAL*

指定複合陣列之實數陣列的指標。 陣列中的元素必須使用遞增順序，不小於 0 且不大於 1。

[in] count

類型： INT

正偶數整數，指定 compoundArray 陣列中的專案數目。 整數不得大於複合陣列中的專案數目。

傳回值

類型： 狀態

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其他其中一個專案。

備註

假設您想要畫筆繪製兩條平行線，其中第一行的寬度是畫筆寬度的 20%，分隔兩行的空間寬度是畫筆寬度的 50%，而第二行的寬度是畫筆寬度的 30%。 從建立 Pen 物件和實數陣列開始。 接著，您可以將值為 0.0、0.2、0.7 和 1.0 的陣列傳遞至Pen 物件的 Pen：：SetCompoundArray方法，以設定複合陣列。

如果您將 Pen 物件的對齊方式設定為 PenAlignmentInset，就無法使用該畫筆繪製複合線條。

範例

下列範例會建立 Pen 物件，並設定畫筆的複合陣列。 程式碼接著會使用 Pen 物件繪製線條。

VOID Example_SetCompoundArray(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an array of real numbers and a Pen object.
   REAL compVals[6] = {0.0f, 0.2f, 0.5f, 0.7f, 0.9f, 1.0f};
   Pen pen(Color(255, 0, 0, 255), 30);

   // Set the compound array of the pen.
   pen.SetCompoundArray(compVals, 6);

   // Draw a line with the pen.
   graphics.DrawLine(&pen, 5, 20, 405, 200);
}

需求

另請參閱

繪製自訂虛線

筆

Pen：：GetCompoundArray

Pen：：GetCompoundArrayCount

畫筆、線條和矩形