GraphicsPath Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет ряд подключенных линий и кривых. Этот класс не может быть унаследован.
public ref class GraphicsPath sealed : MarshalByRefObject, ICloneable, IDisposable
public sealed class GraphicsPath : MarshalByRefObject, ICloneable, IDisposable
type GraphicsPath = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
Public NotInheritable Class GraphicsPath
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
- Наследование
- Реализации
Комментарии
Note
В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.
Приложения используют пути для рисования контуров фигур, заливки интерьеров фигур и создания обрезки областей. Графический механизм поддерживает координаты геометрических фигур в пути в пространстве координат мира.
Путь может состоять из любого числа цифр (подпаток). Каждая фигура состоит из последовательности подключенных линий и кривых или примитивов геометрической фигуры. Начальная точка фигуры — это первая точка в последовательности подключенных линий и кривых. Конечная точка — это последняя точка последовательности. Начальные и конечные точки примитива геометрической фигуры определяются примитивной спецификацией.
Рисунок, состоящий из последовательности подключенных линий и кривых (чьи начальные и конечные точки могут совпадать) является открытой фигурой, если она не закрыта явным образом. Рисунок можно закрыть явным образом с помощью CloseFigure метода, который закрывает текущую фигуру, подключив линию от конечной точки к начальной точке. Фигура, состоящая из геометрической фигуры, является закрытой фигурой.
Для заполнения и вырезки (например, если путь отрисовывается с помощью FillPath), все открытые цифры закрываются путем добавления строки из первой точки фигуры к последней точке.
Новая фигура неявно запускается при создании пути или при закрытии рисунка. Новый рисунок создается явно при вызове StartFigure метода.
Когда примитив геометрической фигуры добавляется в путь, он добавляет фигуру, содержащую геометрическую фигуру, а также неявно начинает новую фигуру. Следовательно, в пути всегда есть текущая фигура. Когда линии и кривые добавляются в путь, неявная линия добавляется по мере необходимости для подключения конечной точки текущей фигуры к начальной точке новых линий и кривых для формирования последовательности подключенных линий и кривых.
Рисунок имеет направление, описывающее, как линии и сегменты кривой трассируются между начальной точкой и конечной точкой. Направление определяется в порядке добавления линий и кривых на фигуру или определяется примитивом геометрической фигуры. Направление используется для определения интерьеров пути для вырезки и заливки.
Конструкторы
| Имя | Описание |
|---|---|
| GraphicsPath() |
Инициализирует новый экземпляр GraphicsPath класса со значением FillModeAlternate. |
| GraphicsPath(FillMode) |
Инициализирует новый экземпляр GraphicsPath класса с указанным FillMode перечислением. |
| GraphicsPath(Point[], Byte[], FillMode) |
Инициализирует новый экземпляр GraphicsPath класса с указанными PathPointType и массивами и Point указанным FillMode элементом перечисления. |
| GraphicsPath(Point[], Byte[]) |
Инициализирует новый экземпляр GraphicsPath класса с указанными PathPointType и Point массивами. |
| GraphicsPath(PointF[], Byte[], FillMode) |
Инициализирует новый экземпляр GraphicsPath массива с указанными PathPointType и массивами и PointF указанным FillMode элементом перечисления. |
| GraphicsPath(PointF[], Byte[]) |
Инициализирует новый экземпляр GraphicsPath массива с указанными PathPointType и PointF массивами. |
| GraphicsPath(ReadOnlySpan<Point>, ReadOnlySpan<Byte>, FillMode) |
Инициализирует новый экземпляр GraphicsPath класса с указанными PathPointType и массивами и Point указанным FillMode элементом перечисления. |
| GraphicsPath(ReadOnlySpan<PointF>, ReadOnlySpan<Byte>, FillMode) |
Инициализирует новый экземпляр GraphicsPath класса с указанными PathPointType и массивами и Point указанным FillMode элементом перечисления. |
Свойства
| Имя | Описание |
|---|---|
| FillMode |
Возвращает или задает перечислениеFillMode, определяющее, как заполняются внутренние части фигур.GraphicsPath |
| PathData |
Получает, PathData который инкапсулирует массивы точек и типов для этого GraphicsPath. |
| PathPoints |
Возвращает точки в пути. |
| PathTypes |
Возвращает типы соответствующих точек в массиве PathPoints . |
| PointCount |
Возвращает количество элементов в PathPoints массиве или в массиве PathTypes . |
Методы
| Имя | Описание |
|---|---|
| AddArc(Int32, Int32, Int32, Int32, Single, Single) |
Добавляет эллиптические дуги к текущей фигуре. |
| AddArc(Rectangle, Single, Single) |
Добавляет эллиптические дуги к текущей фигуре. |
| AddArc(RectangleF, Single, Single) |
Добавляет эллиптические дуги к текущей фигуре. |
| AddArc(Single, Single, Single, Single, Single, Single) |
Добавляет эллиптические дуги к текущей фигуре. |
| AddBezier(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32) |
Добавляет кубическую кривую Bézier к текущей фигуре. |
| AddBezier(Point, Point, Point, Point) |
Добавляет кубическую кривую Bézier к текущей фигуре. |
| AddBezier(PointF, PointF, PointF, PointF) |
Добавляет кубическую кривую Bézier к текущей фигуре. |
| AddBezier(Single, Single, Single, Single, Single, Single, Single, Single) |
Добавляет кубическую кривую Bézier к текущей фигуре. |
| AddBeziers(Point[]) |
Добавляет последовательность подключенных кубовых кривых Bézier к текущей фигуре. |
| AddBeziers(PointF[]) |
Добавляет последовательность подключенных кубовых кривых Bézier к текущей фигуре. |
| AddBeziers(ReadOnlySpan<Point>) |
Добавляет последовательность подключенных кубовых кривых Bézier к текущей фигуре. |
| AddBeziers(ReadOnlySpan<PointF>) |
Добавляет последовательность подключенных кубовых кривых Bézier к текущей фигуре. |
| AddClosedCurve(Point[], Single) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(Point[]) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(PointF[], Single) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(PointF[]) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(ReadOnlySpan<Point>, Single) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(ReadOnlySpan<Point>) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(ReadOnlySpan<PointF>, Single) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddClosedCurve(ReadOnlySpan<PointF>) |
Добавляет закрытую кривую в этот путь. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddCurve(Point[], Int32, Int32, Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(Point[], Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(Point[]) |
Добавляет кривую сплайна к текущей фигуре. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddCurve(PointF[], Int32, Int32, Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(PointF[], Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(PointF[]) |
Добавляет кривую сплайна к текущей фигуре. Кардиналовая кривая сплайн используется, так как кривая проходит по каждому из точек в массиве. |
| AddCurve(ReadOnlySpan<Point>, Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(ReadOnlySpan<Point>) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(ReadOnlySpan<PointF>, Single) |
Добавляет кривую сплайна к текущей фигуре. |
| AddCurve(ReadOnlySpan<PointF>) |
Добавляет кривую сплайна к текущей фигуре. |
| AddEllipse(Int32, Int32, Int32, Int32) |
Добавляет многоточие в текущий путь. |
| AddEllipse(Rectangle) |
Добавляет многоточие в текущий путь. |
| AddEllipse(RectangleF) |
Добавляет многоточие в текущий путь. |
| AddEllipse(Single, Single, Single, Single) |
Добавляет многоточие в текущий путь. |
| AddLine(Int32, Int32, Int32, Int32) |
Добавляет сегмент строки к текущему рисунку. |
| AddLine(Point, Point) |
Добавляет к этому GraphicsPathсегмент строки. |
| AddLine(PointF, PointF) |
Добавляет к этому GraphicsPathсегмент строки. |
| AddLine(Single, Single, Single, Single) |
Добавляет к этому GraphicsPathсегмент строки. |
| AddLines(Point[]) |
Добавляет ряд сегментов подключенной линии в конец этого GraphicsPath. |
| AddLines(PointF[]) |
Добавляет ряд сегментов подключенной линии в конец этого GraphicsPath. |
| AddLines(ReadOnlySpan<Point>) |
Добавляет ряд сегментов подключенной линии в конец этого GraphicsPath. |
| AddLines(ReadOnlySpan<PointF>) |
Добавляет ряд сегментов подключенной линии в конец этого GraphicsPath. |
| AddPath(GraphicsPath, Boolean) |
Добавляет указанный GraphicsPath путь к этому пути. |
| AddPie(Int32, Int32, Int32, Int32, Single, Single) |
Добавляет контур круговой фигуры в этот путь. |
| AddPie(Rectangle, Single, Single) |
Добавляет контур круговой фигуры в этот путь. |
| AddPie(Single, Single, Single, Single, Single, Single) |
Добавляет контур круговой фигуры в этот путь. |
| AddPolygon(Point[]) |
Добавляет многоугольник в этот путь. |
| AddPolygon(PointF[]) |
Добавляет многоугольник в этот путь. |
| AddPolygon(ReadOnlySpan<Point>) |
Добавляет многоугольник в этот путь. |
| AddPolygon(ReadOnlySpan<PointF>) |
Добавляет многоугольник в этот путь. |
| AddRectangle(Rectangle) |
Добавляет прямоугольник в этот путь. |
| AddRectangle(RectangleF) |
Добавляет прямоугольник в этот путь. |
| AddRectangles(ReadOnlySpan<Rectangle>) |
Добавляет ряд прямоугольников в этот путь. |
| AddRectangles(ReadOnlySpan<RectangleF>) |
Добавляет ряд прямоугольников в этот путь. |
| AddRectangles(Rectangle[]) |
Добавляет ряд прямоугольников в этот путь. |
| AddRectangles(RectangleF[]) |
Добавляет ряд прямоугольников в этот путь. |
| AddRoundedRectangle(Rectangle, Size) |
Добавляет округленный прямоугольник в этот путь. |
| AddRoundedRectangle(RectangleF, SizeF) |
Добавляет округленный прямоугольник в этот путь. |
| AddString(String, FontFamily, Int32, Single, Point, StringFormat) |
Добавляет текстовую строку в этот путь. |
| AddString(String, FontFamily, Int32, Single, PointF, StringFormat) |
Добавляет текстовую строку в этот путь. |
| AddString(String, FontFamily, Int32, Single, Rectangle, StringFormat) |
Добавляет текстовую строку в этот путь. |
| AddString(String, FontFamily, Int32, Single, RectangleF, StringFormat) |
Добавляет текстовую строку в этот путь. |
| ClearMarkers() |
Очищает все маркеры из этого пути. |
| Clone() |
Создает точную копию этого пути. |
| CloseAllFigures() |
Закрывает все открытые цифры в этом пути и запускает новую фигуру. Он закрывает каждую открытую фигуру, подключив линию от конечной точки к начальной точке. |
| CloseFigure() |
Закрывает текущую фигуру и запускает новую фигуру. Если текущая фигура содержит последовательность подключенных линий и кривых, метод закрывает цикл, подключив линию от конечной точки к начальной точке. |
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, используемые этим GraphicsPathпараметром. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Finalize() |
Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора. |
| Flatten() |
Преобразует каждую кривую в этом пути в последовательность подключенных сегментов линий. |
| Flatten(Matrix, Single) |
Преобразует каждую кривую в эту GraphicsPath последовательность подключенных сегментов линий. |
| Flatten(Matrix) |
Применяет указанное преобразование и преобразует каждую кривую в эту GraphicsPath последовательность сегментов подключенной линии. |
| GetBounds() |
Возвращает прямоугольник, ограничивающий этот GraphicsPathобъект. |
| GetBounds(Matrix, Pen) |
Возвращает прямоугольник, ограничивающий это GraphicsPath , когда текущий путь преобразуется заданным Matrix и рисуемым заданным Pen. |
| GetBounds(Matrix) |
Возвращает прямоугольник, ограничивающий этот GraphicsPath путь, когда этот путь преобразуется указанным Matrix. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLastPoint() |
Возвращает последнюю точку в массиве PathPoints этого GraphicsPathобъекта. |
| GetLifetimeService() |
Устаревшие..
Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| GetPathPoints(Span<PointF>) |
Возвращает точки в пути. |
| GetPathTypes(Span<Byte>) |
PathPointType Возвращает типы для точек в пути. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| IsOutlineVisible(Int32, Int32, Pen, Graphics) |
Указывает, содержится ли указанная точка внутри (в) контур этого GraphicsPath при рисовании с указанным Pen и использованием указанного Graphics. |
| IsOutlineVisible(Int32, Int32, Pen) |
Указывает, содержится ли указанная точка внутри (под) контуром при GraphicsPath рисовании с указанным Pen. |
| IsOutlineVisible(Point, Pen, Graphics) |
Указывает, содержится ли указанная точка внутри (в) контур этого GraphicsPath при рисовании с указанным Pen и использованием указанного Graphics. |
| IsOutlineVisible(Point, Pen) |
Указывает, содержится ли указанная точка внутри (под) контуром при GraphicsPath рисовании с указанным Pen. |
| IsOutlineVisible(PointF, Pen, Graphics) |
Указывает, содержится ли указанная точка внутри (в) контур этого GraphicsPath при рисовании с указанным Pen и использованием указанного Graphics. |
| IsOutlineVisible(PointF, Pen) |
Указывает, содержится ли указанная точка внутри (под) контуром при GraphicsPath рисовании с указанным Pen. |
| IsOutlineVisible(Single, Single, Pen, Graphics) |
Указывает, содержится ли указанная точка внутри (в) контур этого GraphicsPath при рисовании с указанным Pen и использованием указанного Graphics. |
| IsOutlineVisible(Single, Single, Pen) |
Указывает, содержится ли указанная точка внутри (под) контуром при GraphicsPath рисовании с указанным Pen. |
| IsVisible(Int32, Int32, Graphics) |
Указывает, содержится ли указанная точка в этом GraphicsPathпараметре, используя указанный Graphicsпараметр. |
| IsVisible(Int32, Int32) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| IsVisible(Point, Graphics) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| IsVisible(Point) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| IsVisible(PointF, Graphics) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| IsVisible(PointF) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| IsVisible(Single, Single, Graphics) |
Указывает, содержится ли указанная точка внутри этой GraphicsPath области в видимой области клипа указанного Graphicsобъекта. |
| IsVisible(Single, Single) |
Указывает, содержится ли указанная точка в этом GraphicsPathэлементе. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject) |
| Reset() |
Очищает PathPoints и PathTypes задает значение FillModeAlternate. |
| Reverse() |
Изменяет порядок точек в массиве PathPoints этого GraphicsPathмассива. |
| SetMarkers() |
Задает маркер для этого GraphicsPath. |
| StartFigure() |
Запускает новую фигуру, не закрывая текущую фигуру. Все последующие точки, добавленные в путь, добавляются на этот новый рисунок. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| Transform(Matrix) |
Применяет матрицу преобразования к этому GraphicsPath. |
| Warp(PointF[], RectangleF, Matrix, WarpMode, Single) |
Применяет преобразование warp, определенное прямоугольником и параллелограммой, к этому GraphicsPath. |
| Warp(PointF[], RectangleF, Matrix, WarpMode) |
Применяет преобразование warp, определенное прямоугольником и параллелограммой, к этому GraphicsPath. |
| Warp(PointF[], RectangleF, Matrix) |
Применяет преобразование warp, определенное прямоугольником и параллелограммой, к этому GraphicsPath. |
| Warp(PointF[], RectangleF) |
Применяет преобразование warp, определенное прямоугольником и параллелограммой, к этому GraphicsPath. |
| Warp(ReadOnlySpan<PointF>, RectangleF, Matrix, WarpMode, Single) |
Применяет преобразование warp, определенное прямоугольником и параллелограммой, к этому GraphicsPath. |
| Widen(Pen, Matrix, Single) |
Заменяет это кривыми, заключающими область, заполненную, когда этот GraphicsPath путь рисуется указанным пером. |
| Widen(Pen, Matrix) |
Добавляет дополнительную структуру в объект GraphicsPath. |
| Widen(Pen) |
Добавляет дополнительную структуру в путь. |