Поделиться через


Pen Класс

Определение

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

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
Наследование
Реализации

Примеры

В следующем примере кода демонстрируется создание 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)

Выполняет перевод локального геометрического преобразования на заданные размеры в заданном порядке.

Применяется к