Pen Класс

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Определяет объект, используемый для рисования прямых линий и кривых. Этот класс не наследуется.

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable

public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable

type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable

Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable

Наследование

Object

MarshalByRefObject

Pen

Реализации

ICloneable IDisposable

Примеры

В следующем примере кода демонстрируется создание Pen с помощью Brush и эффекты задания LineJoin свойства для Pen.

Этот пример предназначен для использования с Windows Forms. Вставьте код в форму и вызовите ShowLineJoin метод при обработке события формы Paint , передавая e как PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Комментарии

Рисует Pen линию указанной ширины и стиля. Используйте свойство для DashStyle рисования нескольких разновидностей пунктирных линий. Линия, нарисованная , Pen может быть заполнена различными стилями заливки, включая сплошные цвета и текстуры. Стиль заливки зависит от кисти или текстуры, используемой в качестве объекта заливки.

Примечание

В .NET 6 и более поздних версиях пакет System.Drawing.Common, включающий этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см . в статье System.Drawing.Common, поддерживаемая только в Windows.

Конструкторы

Pen(Brush)	Инициализирует новый экземпляр класса Pen указанным значением Brush.
Pen(Brush, Single)	Инициализирует новый экземпляр класса Pen с заданными свойствами Brush и Width.
Pen(Color)	Инициализирует новый экземпляр класса Pen указанным цветом.
Pen(Color, Single)	Инициализирует новый экземпляр класса Pen указанными свойствами Color и Width.

Свойства

Alignment	Возвращает или задает выравнивание для объекта Pen.
Brush	Возвращает или задает объект Brush, определяющий атрибуты объекта Pen.
Color	Возвращает или задает цвет объекта Pen.
CompoundArray	Возвращает или задает массив значений, определяющий составное перо. Составное перо рисует составную линию, состоящую из параллельных линий и промежутков.
CustomEndCap	Возвращает или задает настраиваемое завершение для использования в конце линий, нарисованных при помощи пера Pen.
CustomStartCap	Возвращает или задает настраиваемое завершение, используемое в начале линий, нарисованных при помощи пера Pen.
DashCap	Возвращает или задает стиль завершения, ограничивающего пунктирные линии, нарисованные при помощи объекта Pen.
DashOffset	Возвращает или задает расстояние от начала линии до начала шаблона штриха.
DashPattern	Возвращает или задает массив настраиваемых штрихов и промежутков.
DashStyle	Возвращает или задает стиль, используемый для пунктирных линий, нарисованных при помощи объекта Pen.
EndCap	Возвращает или задает стиль завершения линий, нарисованных при помощи объекта Pen.
LineJoin	Возвращает или задает объединенный стиль завершений для двух последовательных линий, нарисованных при помощи объекта Pen.
MiterLimit	Возвращает или задает ограничение толщины соединения скошенных углов.
PenType	Возвращает или задает стиль линий, нарисованных с помощью объекта Pen.
StartCap	Возвращает или задает стиль завершения, используемый в начале линий, рисуемых при помощи объекта Pen.
Transform	Возвращает или задает копию геометрического преобразования объекта Pen.
Width	Возвращает или устанавливает ширину пера Pen, в единицах измерения объекта Graphics, используемого для рисования.

Методы

Clone()	Создает точную копию данного объекта Pen.
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые этим объектом Pen.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Finalize()	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
MultiplyTransform(Matrix)	Умножает матрицу преобразования объекта Pen на заданный объект Matrix.
MultiplyTransform(Matrix, MatrixOrder)	Умножает матрицу преобразования объекта Pen на заданный объект Matrix в заданном порядке.
ResetTransform()	Возвращает матрице геометрического преобразования объекта Pen единичное значение.
RotateTransform(Single)	Поворачивает локальное геометрическое преобразование на заданный угол. Этот метод добавляет поворот перед преобразованием.
RotateTransform(Single, MatrixOrder)	Поворачивает локальное геометрическое преобразование на заданный угол в заданном порядке.
ScaleTransform(Single, Single)	Выполняет изменение масштаба локального геометрического преобразования при помощи заданных коэффициентов. Этот метод вставляет изменение масштаба перед преобразованием.
ScaleTransform(Single, Single, MatrixOrder)	Изменяет масштаб локального геометрического преобразования при помощи заданных коэффициентов в заданном порядке.
SetLineCap(LineCap, LineCap, DashCap)	Устанавливает значения, определяющие стиль завершения, используемый в конце линий, нарисованных при помощи объекта Pen.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TranslateTransform(Single, Single)	Выполняет перевод локального геометрического преобразования на заданные размеры. Этот метод вставляет перевод перед преобразованием.
TranslateTransform(Single, Single, MatrixOrder)	Выполняет перевод локального геометрического преобразования на заданные размеры в заданном порядке.