Pen Класс

Определение

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

Свойства

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.

Методы

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.

(Унаследовано от MarshalByRefObject)
Dispose()

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

Equals(Object)

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

(Унаследовано от 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.

(Унаследовано от Object)
GetLifetimeService()

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

(Унаследовано от MarshalByRefObject)
GetType()

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

(Унаследовано от Object)
InitializeLifetimeService()

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

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

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

(Унаследовано от Object)
MemberwiseClone(Boolean)

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

(Унаследовано от 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.

(Унаследовано от 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.

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