Pen Pen Pen Pen Class

Определение

Определяет объект, используемый для рисования прямых линий и кривых.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
Наследование
Реализации

Примеры

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

Комментарии

Объект 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.

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

Pen(Brush) Pen(Brush) Pen(Brush) Pen(Brush)

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

Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single)

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

Pen(Color) Pen(Color) Pen(Color) Pen(Color)

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

Pen(Color, Single) Pen(Color, Single) Pen(Color, Single) Pen(Color, Single)

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

Свойства

Alignment Alignment Alignment Alignment

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

Brush Brush Brush Brush

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

Color Color Color Color

Получает или задает цвет объекта Pen.Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray 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 CustomEndCap CustomEndCap CustomEndCap

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

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

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

DashCap DashCap DashCap 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 DashOffset DashOffset DashOffset

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

DashPattern DashPattern DashPattern DashPattern

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

DashStyle DashStyle DashStyle DashStyle

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

EndCap EndCap EndCap EndCap

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

LineJoin LineJoin LineJoin LineJoin

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

MiterLimit MiterLimit MiterLimit MiterLimit

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

PenType PenType PenType PenType

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

StartCap StartCap StartCap StartCap

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

Transform Transform Transform Transform

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

Width Width Width Width

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

Методы

Clone() Clone() Clone() Clone()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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() Dispose() Dispose() Dispose()

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

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

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

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

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

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

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

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

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

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

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) 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) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

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

SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap)

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

ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

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

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

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

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