Метод Pen::SetCompoundArray (gdipluspen.h)

Статья
08/24/2023

Метод Pen::SetCompoundArray задает составной массив для этого объекта Pen .

Синтаксис

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

Параметры

[in] compoundArray

Тип: const REAL*

Указатель на массив реальных чисел, указывающий составной массив. Элементы массива должны быть числами от 0 до 1, расположенными в порядке возрастания.

[in] count

Тип: INT

Положительное четное целое число, указывающее количество элементов в массиве compoundArray . Целое число не должно быть больше числа элементов в составном массиве.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Предположим, вы хотите, чтобы перо нарисовало две параллельные линии, где ширина первой линии составляет 20 процентов от ширины пера, ширина пространства, разделяющего две линии, составляет 50 процентов ширины пера, а ширина второй линии — 30 процентов от ширины пера. Начните с создания объекта Pen и массива реальных чисел. Затем можно задать составной массив, передав массив со значениями 0,0, 0,2, 0,7 и 1,0 в метод Pen::SetCompoundArray объекта Pen .

Если для объекта 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);
}

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdipluspen.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll