GDI+ Лекция из курса «Введение в программирование на C# 2.0»

2007 г.

GDI+
Лекция из курса «Введение в программирование на C# 2.0»

Марченко Антон Леонардович
Интернет-Университет Информационных Технологий, INTUIT.ru

GraphicsPath

GraphicsPath – класс, представляющий последовательность соединенных линий и кривых. Приложения используют контуры для отображения очертаний фигур, заполнения внутренних областей фигур, создания областей отсечения.

Контур может состоять из любого числа фигур (контуров). Каждая фигура либо составлена из последовательности линий и кривых, либо является геометрическим примитивом. Начальная точка фигуры – первая точка в последовательности соединенных линий и кривых. Конечная точка – последняя точка в последовательности.

Фигура, состоящая из последовательности соединенных линий и кривых (чьи начальная и конечная точки могут совпадать), является разомкнутой фигурой, если она не замкнута явно. Фигура может быть замкнута явно с помощью метода CloseFigure, который замыкает фигуру путем соединения конечной и начальной точек линией. Фигура, состоящая из геометрического примитива, является замкнутой.

Для целей заполнения и отсечения (например, если контур визуализируется с помощью метода Graphics.FillPath) все разомкнутые фигуры замыкаются путем добавления линии от первой точки фигуры к последней.

Новая фигура начинается неявно, когда создается контур или фигура замыкается. Новая фигура создается явно, когда вызывается метод StartFigure.

Когда к контуру добавляется геометрический примитив, то он добавляет фигуру, содержащую геометрический примитив, а также неявно начинает новую фигуру. Следовательно, в контуре всегда существует текущая фигура. Когда линии и кривые добавляются к контуру, то добавляется неявная линия, соединяющая конечную точку текущей фигуры с начальной точкой новых линий и кривых, чтобы сформировать последовательность соединенных линий и кривых.

У фигуры есть направление, определяющее, как отрезки прямых и кривых следуют от начальной точки к конечной. Направление задается либо порядком добавления линий и кривых к фигуре, либо геометрическим примитивом. Направление используется для определения внутренних областей контура для целей отсечения и заполнения. О структуре и назначении классов можно судить по списку членов класса, который представлен ниже.

Конструкторы
`GraphicsPath`-конструктор	Инициализирует новый экземпляр класса `GraphicsPath` с перечислением `FillMode` из `Alternate`

Свойства
`FillMode`	Получает или задает перечисление `FillMode`, определяющее, как заполняются внутренние области фигур в объекте `GraphicsPath`
`PathPoints`	Получает точки в контуре
`PathTypes`	Получает типы соответствующих точек в массиве `PathPoints`
`PointCount`	Получает число элементов в массиве `PathPoints` или `PathTypes`

Методы
`AddArc`	Присоединяет дугу эллипса к текущей фигуре
`AddBezier`	Добавляет в текущую фигуру кривую Безье третьего порядка
`AddBeziers`	Добавляет в текущую фигуру последовательность соединенных кривых Безье третьего порядка
`AddClosedCurve`	Добавляет замкнутую кривую к данному контуру. Используется кривая фундаментального сплайна, поскольку кривая проходит через все точки массива
`AddCurve`	Добавляет в текущую фигуру кривую сплайна. Используется кривая фундаментального сплайна, поскольку кривая проходит через все точки массива
`AddEllipse`	Добавляет эллипс к текущему пути
`AddLine`	Добавляет отрезок прямой к объекту `GraphicsPath`
`AddLines`	Добавляет последовательность соединенных отрезков прямых в конец объекта `GraphicsPath`
`AddPath`	Добавляет указанный объект `GraphicsPath` к данному контуру
`AddPie`	Добавляет контур сектора к данному контуру
`AddPolygon`	Добавляет многоугольник к данному контуру
`AddRectangle`	Добавляет прямоугольник к данному контуру
`AddRectangles`	Добавляет последовательность прямоугольников к данному контуру
`AddString`	Добавляет строку текста в данный путь
`ClearMarkers`	Удаляет все маркеры из данного контура
`Clone`	Создает точную копию данного контура
`CloseAllFigures`	Замыкает все незамкнутые фигуры в данном контуре и открывает новую фигуру. Каждая незамкнутая фигура замыкается путем соединения ее начальной и конечной точек линией
`CloseFigure`	Замыкает текущую фигуру и открывает новую. Если текущая фигура содержит последовательность соединенных линий и кривых, то метод замыкает ее путем соединения начальной и конечной точек линией
`CreateObjRef` (унаследовано от `Marshal By RefObject`)	Создает объект, который содержит всю необходимую информацию для конструирования прокси-сервера, используемого для коммуникации с удаленными объектами
`Dispose`	Освобождает все ресурсы, используемые объектом `GraphicsPath`
`Equals` (унаследовано от `Object`)	Определяет, равны ли два экземпляра `Object`
`Flatten`	Преобразует каждую кривую в данном контуре в последовательность соединенных отрезков прямых
`GetBounds`	Возвращает прямоугольник, ограничивающий объект `GraphicsPath`
`GetHashCode (унаследовано от Object)`	Служит хэш-функцией для конкретного типа, пригоден для использования в алгоритмах хэширования и структурах данных, например, в хэш-таблице
`GetLastPoint`	Получает последнюю точку массива `PathPoints` объекта `GraphicsPath`
`GetLifetimeService` (унаследовано от `MarshalByRefObject`)	Извлекает служебный объект текущего срока действия, который управляет средствами срока действия данного экземпляра
`GetType` (унаследовано от `Object`)	Возвращает `Type` текущего экземпляра
`InitializeLifetimeService` (унаследовано от `MarshalByRefObject`)	Получает служебный объект срока действия, для управления средствами срока действия данного экземпляра
`IsOutlineVisible`	Указывает, содержится ли определенная точка внутри (под) контура объекта `GraphicsPath` при отображении его с помощью указанного объекта `Pen`
`IsVisible`	Определяет, содержится ли указанная точка в объекте `GraphicsPath`
`Reset`	Очищает массивы `PathPoints` и `PathTypes` и устанавливает `FillMode` в `Alternate`
`Reverse`	Изменяет порядок точек в массиве `PathPoints` объекта `GraphicsPath` на противоположный
`SetMarkers`	Устанавливает маркер на объекте `GraphicsPath`
`StartFigure`	Открывает новую фигуру, не замыкая при этом текущую. Все последующие точки, добавляемые к контуру, добавляются к новой фигуре
`ToString` (унаследовано от `Object`)	Возвращает `String`, который представляет текущий `Object`
`Transform`	Применяет матрицу преобразования к объекту `GraphicsPath`
`Warp`	Применяет преобразование перекоса, определяемое прямоугольником и параллелограммом, к объекту `GraphicsPath`
`Widen`	Заменяет данный контур кривыми, которые окружают область, заполняемую при отображении контура указанным пером

Защищенные методы
`Finalize`	Переопределен. См. `Object.Finalize`. В языках C# и C++ для функций финализации используется синтаксис деструктора
`MemberwiseClone` (унаследовано от `Object`)	Создает неполную копию текущего `Object`

Назад Оглавление Вперёд