GraphicsPath – класс, представляющий последовательность соединенных линий и кривых. Класс не наследуется. Список членов класса представляется ниже.
Приложения используют контуры для отображения очертаний фигур, заполнения внутренних областей фигур, создания областей отсечения.
Контур может состоять из любого числа фигур (контуров). Каждая фигура либо составлена из последовательности линий и кривых, либо является геометрическим примитивом. Начальная точка фигуры – первая точка в последовательности соединенных линий и кривых. Конечная точка – последняя точка в последовательности.
Фигура, состоящая из последовательности соединенных линий и кривых (чьи начальная и конечная точки могут совпадать), является разомкнутой фигурой, если она не замкнута явно. Фигура может быть замкнута явно с помощью метода CloseFigure, который замыкает фигуру путем соединения конечной и начальной точек линией. Фигура, состоящая из геометрического примитива, является замкнутой.
Для целей заполнения и отсечения (например, если контур визуализируется с помощью метода Graphics.FillPath) все разомкнутые фигуры замыкаются путем добавления линии от первой точки фигуры к последней.
Новая фигура начинается неявно, когда создается контур или фигура замыкается. Новая фигура создается явно, когда вызывается метод StartFigure.
Когда к контуру добавляется геометрический примитив, то он добавляет фигуру, содержащую геометрический примитив, а также неявно начинает новую фигуру. Следовательно, в контуре всегда существует текущая фигура. Когда линии и кривые добавляются к контуру, то добавляется неявная линия, соединяющая конечную точку текущей фигуры с начальной точкой новых линий и кривых, чтобы сформировать последовательность соединенных линий и кривых.
У фигуры есть направление, определяющее, как отрезки прямых и кривых следуют от начальной точки к конечной. Направление определяется либо порядком добавления линий и кривых к фигуре, либо геометрическим примитивом. Направление используется для определения внутренних областей контура для целей отсечения и заполнения. О структуре и назначении классов можно судить по списку членов класса, который представлен ниже.
Конструкторы
GraphicsPath - конструктор
Инициализирует новый экземпляр класса GraphicsPath с перечислением FillMode из Alternate.
Свойства
FillMode
Получает или задает перечисление FillMode, определяющее, как заполняются внутренние области фигур в объекте GraphicsPath.
PathData
Получает объект PathData, инкапсулирующий массивы точек (points) и типов (types) для объекта 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 (унаследовано от MarshalByRefObject)
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для коммуникации с удаленными объектами.
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.
Region
Описывает внутреннюю часть графической формы, состоящей из прямоугольников и фигур, составленных из замкнутых линий. Этот класс не наследуется.
Область является масштабируемой. Приложение может использовать области для фиксации выходных данных операций рисования. Диспетчер окон использует области для определения области изображения окон. Эти области называются вырезанными. Приложение может также использовать области в операциях проверки наличия данных, например пересечения точки или прямоугольника с областью. Приложение может заполнять область с помощью объекта Brush.
Множество пикселов, входящих в состав региона, может состоять из нескольких несмежных участков.
Список членов класса представляется ниже.
Открытые конструкторы
Region - конструктор
Инициализирует новый объект Region.
Открытые методы
Clone
Создает точную копию объекта Region.
Complement
Обновляет объект Region, чтобы включить часть указанной структуры RectangleF, не пересекающуюся с объектом Region.
CreateObjRef (унаследовано от MarshalByRefObject)
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для коммуникации с удаленными объектами.
Dispose
Освобождает все ресурсы, используемые объектом Region.
Equals
Exclude
Обновляет объект Region, чтобы включить часть его внутренней части, не пересекающуюся с указанной структурой Rectangle.
FromHrgn
Инициализирует новый объект Region из дескриптора указанной существующей области GDI.
GetBounds
Возвращает структуру RectangleF, представляющую прямоугольник, ограничивающий объект Region на поверхности рисунка объекта Graphics.
GetHashCode (унаследовано от Object)
Служит хеш-функцией для конкретного типа, пригоден для использования в алгоритмах хеширования и структурах данных, например в хеш-таблице.
GetHrgn
Возвращает дескриптор Windows для объекта Region в указанном графическом контексте.
GetLifetimeService (унаследовано от MarshalByRefObject)
Извлекает служебный объект текущего срока действия, который управляет средствами срока действия данного экземпляра.
GetRegionData
Возвращает объект RegionData, представляющий данные, описывающие объект Region.
GetRegionScans
Возвращает массив структур RectangleF, аппроксимирующих объект Region.
GetType (унаследовано от Object)
Возвращает Type текущего экземпляра.
InitializeLifetimeService (унаследовано от MarshalByRefObject)
Получает служебный объект срока действия, для управления средствами срока действия данного экземпляра.
Intersect
Заменяет объект Region на его пересечение с указанным объектом Region.
IsEmpty
Проверяет, имеет ли объект Region пустую внутреннюю часть на указанной поверхности рисунка.
IsInfinite
Проверяет, имеет ли объект Region пустую внутреннюю часть на указанной поверхности рисунка.
IsVisible
Проверяет, содержится ли указанный прямоугольник в объекте Region.
MakeEmpty
Инициализирует объект Region для пустой внутренней части.
MakeInfinite
Инициализирует объект Region для бесконечной внутренней части.
ToString (унаследовано от Object)
Возвращает String, который представляет текущий Object.
Transform
Преобразует этот объект Region с помощью указанного объекта Matrix.
Translate
Смещает координаты объекта Region на указанную величину.
Union
Заменяет объект Region на его объединение с указанным объектом GraphicsPath.
Xor
Заменяет объект Region на разность объединения и его пересечения с указанным объектом GraphicsPath.
Защищенные методы
Finalize
Переопределен. См. Object.Finalize.
В языках C# и C++ для функций финализации используется синтаксис деструктора.
