Pen Class

Definition

Определяет объект, используемый для рисования прямых линий и кривых.Defines an object used to draw lines and curves. Этот класс не может быть унаследован.This class cannot be inherited.

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
Inheritance
Implements

Examples

В следующем примере кода демонстрируется создание Pen с Brush и влияние задания свойства LineJoin на Pen.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Вставьте код в форму и вызовите метод ShowLineJoin при обработке события Paint формы, передав e как PaintEventArgs.Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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

Remarks

Pen рисует линию с указанными шириной и стилем.A Pen draws a line of specified width and style. Используйте свойство DashStyle, чтобы нарисовать несколько штрихов пунктирных линий.Use the DashStyle property to draw several varieties of dashed lines. Линия, нарисованная Pen, может быть заполнена различными стилями заливки, включая сплошные цвета и текстуры.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. Стиль заливки зависит от кисти или текстуры, используемой в качестве объекта заливки.The fill style depends on brush or texture that is used as the fill object.

Constructors

Pen(Brush)

Инициализирует новый экземпляр класса Pen с указанными параметрами Brush.Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single)

Инициализирует новый экземпляр класса Pen с заданными свойствами Brush и Width.Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color)

Инициализирует новый экземпляр класса Pen указанным цветом.Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single)

Инициализирует новый экземпляр класса Pen указанными свойствами Color и Width.Initializes a new instance of the Pen class with the specified Color and Width properties.

Properties

Alignment

Возвращает или задает выравнивание для объекта Pen.Gets or sets the alignment for this Pen.

Brush

Возвращает или задает объект Brush, определяющий атрибуты объекта Pen.Gets or sets the Brush that determines attributes of this Pen.

Color

Возвращает или задает цвет объекта Pen.Gets or sets the color of this Pen.

CompoundArray

Возвращает или задает массив значений, определяющий составное перо.Gets or sets an array of values that specifies a compound pen. Составное перо рисует составную линию, состоящую из параллельных линий и промежутков.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap

Возвращает или задает настраиваемое завершение для использования в конце линий, нарисованных при помощи пера Pen.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap

Возвращает или задает настраиваемое завершение, используемое в начале линий, нарисованных при помощи пера Pen.Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap

Возвращает или задает стиль завершения, ограничивающего пунктирные линии, нарисованные при помощи объекта Pen.Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset

Возвращает или задает расстояние от начала линии до начала шаблона штриха.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern

Возвращает или задает массив настраиваемых штрихов и промежутков.Gets or sets an array of custom dashes and spaces.

DashStyle

Возвращает или задает стиль, используемый для пунктирных линий, нарисованных при помощи объекта Pen.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap

Возвращает или задает стиль завершения линий, нарисованных при помощи объекта Pen.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin

Возвращает или задает объединенный стиль завершений для двух последовательных линий, нарисованных при помощи объекта Pen.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit

Возвращает или задает ограничение толщины соединения скошенных углов.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType

Возвращает или задает стиль линий, нарисованных с помощью объекта Pen.Gets the style of lines drawn with this Pen.

StartCap

Возвращает или задает стиль завершения, используемый в начале линий, рисуемых при помощи объекта Pen.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform

Возвращает или задает копию геометрического преобразования объекта Pen.Gets or sets a copy of the geometric transformation for this Pen.

Width

Возвращает или устанавливает ширину пера Pen, в единицах измерения объекта Graphics, используемого для рисования.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Methods

Clone()

Создает точную копию данного объекта Pen.Creates an exact copy of this Pen.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose()

Освобождает все ресурсы, используемые этим объектом Pen.Releases all resources used by this Pen.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix)

Умножает матрицу преобразования объекта Pen на заданный объект Matrix.Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Умножает матрицу преобразования объекта Pen на заданный объект Matrix в заданном порядке.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform()

Возвращает матрице геометрического преобразования объекта Pen единичное значение.Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single)

Поворачивает локальное геометрическое преобразование на заданный угол.Rotates the local geometric transformation by the specified angle. Этот метод добавляет поворот перед преобразованием.This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder)

Поворачивает локальное геометрическое преобразование на заданный угол в заданном порядке.Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single)

Выполняет изменение масштаба локального геометрического преобразования при помощи заданных коэффициентов.Scales the local geometric transformation by the specified factors. Этот метод вставляет изменение масштаба перед преобразованием.This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder)

Изменяет масштаб локального геометрического преобразования при помощи заданных коэффициентов в заданном порядке.Scales the local geometric transformation by the specified factors in the specified order.

SetLineCap(LineCap, LineCap, DashCap)

Устанавливает значения, определяющие стиль завершения, используемый в конце линий, нарисованных при помощи объекта Pen.Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single)

Выполняет перевод локального геометрического преобразования на заданные размеры.Translates the local geometric transformation by the specified dimensions. Этот метод вставляет перевод перед преобразованием.This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder)

Выполняет перевод локального геометрического преобразования на заданные размеры в заданном порядке.Translates the local geometric transformation by the specified dimensions in the specified order.

Applies to