Pen Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define um objeto usado para desenhar linhas e curvas. Essa classe não pode ser herdada.
public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposablepublic sealed class Pen : MarshalByRefObject, ICloneable, IDisposabletype Pen = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposablePublic NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable- Herança
- Implementações
Exemplos
O exemplo de código a seguir demonstra a construção de um PenBrush com e os efeitos de definir a LineJoin propriedade em um Pen.
Este exemplo foi projetado para ser usado com o Windows Forms. Cole o código em um formulário e chame o ShowLineJoin método ao manipular o evento do Paint formulário, passando e como 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
Comentários
Desenha Pen uma linha de largura e estilo especificados. Use a DashStyle propriedade para desenhar várias variedades de linhas tracejadas. A linha desenhada por um Pen pode ser preenchida em uma variedade de estilos de preenchimento, incluindo cores sólidas e texturas. O estilo de preenchimento depende do pincel ou textura que é usado como o objeto de preenchimento.
Observação
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.
Construtores
| Nome | Description |
|---|---|
| Pen(Brush, Single) |
Inicializa uma nova instância da Pen classe com o especificado Brush e Width. |
| Pen(Brush) |
Inicializa uma nova instância da Pen classe com a especificada Brush. |
| Pen(Color, Single) |
Inicializa uma nova instância da Pen classe com as propriedades e Width especificadasColor. |
| Pen(Color) |
Inicializa uma nova instância da Pen classe com a cor especificada. |
Propriedades
| Nome | Description |
|---|---|
| Alignment |
Obtém ou define o alinhamento para isso Pen. |
| Brush |
Obtém ou define o Brush que determina os atributos deste Pen. |
| Color |
Obtém ou define a cor deste Pen. |
| CompoundArray |
Obtém ou define uma matriz de valores que especifica uma caneta composta. Uma caneta composta desenha uma linha composta composta de linhas e espaços paralelos. |
| CustomEndCap |
Obtém ou define um limite personalizado a ser usado no final das linhas desenhadas com isso Pen. |
| CustomStartCap |
Obtém ou define um limite personalizado a ser usado no início das linhas desenhadas com isso Pen. |
| DashCap |
Obtém ou define o estilo de tampa usado no final dos traços que compõem linhas tracejadas desenhadas com isso Pen. |
| DashOffset |
Obtém ou define a distância do início de uma linha até o início de um padrão de traço. |
| DashPattern |
Obtém ou define uma matriz de traços e espaços personalizados. |
| DashStyle |
Obtém ou define o estilo usado para linhas tracejadas desenhadas com este Pen. |
| EndCap |
Obtém ou define o estilo de limite usado no final das linhas desenhadas com este Pen. |
| LineJoin |
Obtém ou define o estilo de junção para as extremidades de duas linhas consecutivas desenhadas com isso Pen. |
| MiterLimit |
Obtém ou define o limite da espessura da junção em um canto miterado. |
| PenType |
Obtém o estilo de linhas desenhadas com este Pen. |
| StartCap |
Obtém ou define o estilo de limite usado no início das linhas desenhadas com este Pen. |
| Transform |
Obtém ou define uma cópia da transformação geométrica para isso Pen. |
| Width |
Obtém ou define a largura disso Pen, em unidades do Graphics objeto usado para desenho. |
Métodos
| Nome | Description |
|---|---|
| Clone() |
Cria uma cópia exata disso Pen. |
| CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados por isso Pen. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo. |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MultiplyTransform(Matrix, MatrixOrder) |
Multiplica a matriz de transformação para isso Pen pela ordem especificada Matrix . |
| MultiplyTransform(Matrix) |
Multiplica a matriz de transformação para isso Pen pelo especificado Matrix. |
| ResetTransform() |
Redefine a matriz de transformação geométrica para essa Pen identidade. |
| RotateTransform(Single, MatrixOrder) |
Gira a transformação geométrica local pelo ângulo especificado na ordem especificada. |
| RotateTransform(Single) |
Gira a transformação geométrica local pelo ângulo especificado. Esse método prepara a rotação para a transformação. |
| ScaleTransform(Single, Single, MatrixOrder) |
Dimensiona a transformação geométrica local pelos fatores especificados na ordem especificada. |
| ScaleTransform(Single, Single) |
Dimensiona a transformação geométrica local pelos fatores especificados. Esse método prepara a matriz de dimensionamento para a transformação. |
| SetLineCap(LineCap, LineCap, DashCap) |
Define os valores que determinam o estilo de limite usado para finalizar linhas desenhadas por isso Pen. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TranslateTransform(Single, Single, MatrixOrder) |
Converte a transformação geométrica local pelas dimensões especificadas na ordem especificada. |
| TranslateTransform(Single, Single) |
Converte a transformação geométrica local pelas dimensões especificadas. Esse método prepara a tradução para a transformação. |
