CustomLineCap 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.
Encapsula uma terminação de linha personalizada definida pelo usuário.
public ref class CustomLineCap : MarshalByRefObject, ICloneable, IDisposable
public class CustomLineCap : MarshalByRefObject, ICloneable, IDisposable
type CustomLineCap = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
Public Class CustomLineCap
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
- Herança
- Derivado
- Implementações
Exemplos
O exemplo a seguir demonstra como usar a CustomLineCap classe . Para executar este exemplo, cole o código em um Formulário do Windows. Manipule o evento do Paint formulário e chame DrawCaps
do método de tratamento de eventos do Paint formulário, passando e
como PaintEventArgs.
protected void DrawCaps(PaintEventArgs e)
{
GraphicsPath hPath = new GraphicsPath();
// Create the outline for our custom end cap.
hPath.AddLine(new Point(0, 0), new Point(0, 5));
hPath.AddLine(new Point(0, 5), new Point(5, 1));
hPath.AddLine(new Point(5, 1), new Point(3, 1));
// Construct the hook-shaped end cap.
CustomLineCap HookCap = new CustomLineCap(null, hPath);
// Set the start cap and end cap of the HookCap to be rounded.
HookCap.SetStrokeCaps(LineCap.Round, LineCap.Round);
// Create a pen and set end custom start and end
// caps to the hook cap.
Pen customCapPen = new Pen(Color.Black, 5);
customCapPen.CustomStartCap = HookCap;
customCapPen.CustomEndCap = HookCap;
// Create a second pen using the start and end caps from
// the hook cap.
Pen capPen = new Pen(Color.Red, 10);
LineCap startCap;
LineCap endCap;
HookCap.GetStrokeCaps(out startCap, out endCap);
capPen.StartCap = startCap;
capPen.EndCap = endCap;
// Create a line to draw.
Point[] points = { new Point(100, 100), new Point(200, 50),
new Point(250, 300) };
// Draw the lines.
e.Graphics.DrawLines(capPen, points);
e.Graphics.DrawLines(customCapPen, points);
}
Protected Sub DrawCaps(ByVal e As PaintEventArgs)
Dim hPath As New GraphicsPath()
' Create the outline for our custom end cap.
hPath.AddLine(New Point(0, 0), New Point(0, 5))
hPath.AddLine(New Point(0, 5), New Point(5, 1))
hPath.AddLine(New Point(5, 1), New Point(3, 1))
' Construct the hook-shaped end cap.
Dim HookCap As New CustomLineCap(Nothing, hPath)
' Set the start cap and end cap of the HookCap to be rounded.
HookCap.SetStrokeCaps(LineCap.Round, LineCap.Round)
' Create a pen and set end custom start and end
' caps to the hook cap.
Dim customCapPen As New Pen(Color.Black, 5)
customCapPen.CustomStartCap = HookCap
customCapPen.CustomEndCap = HookCap
' Create a second pen using the start and end caps from
' the hook cap.
Dim capPen As New Pen(Color.Red, 10)
Dim startCap As LineCap
Dim endCap As LineCap
HookCap.GetStrokeCaps(startCap, endCap)
capPen.StartCap = startCap
capPen.EndCap = endCap
' Create a line to draw.
Dim points As Point() = {New Point(100, 100), New Point(200, 50), _
New Point(250, 300)}
' Draw the lines.
e.Graphics.DrawLines(capPen, points)
e.Graphics.DrawLines(customCapPen, points)
End Sub
Comentários
As tampas de linha são usadas nos inícios e extremidades de linhas ou curvas desenhadas por objetos GDI+ Pen . O GDI+ dá suporte a vários estilos de limite predefinidos e também permite que os usuários definam seus próprios estilos de limite. Essa classe é usada para criar estilos de limite personalizados.
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
CustomLineCap(GraphicsPath, GraphicsPath) |
Inicializa uma nova instância da classe CustomLineCap com o estrutura de tópicos e o preenchimento personalizados. |
CustomLineCap(GraphicsPath, GraphicsPath, LineCap) |
Inicializa uma nova instância da classe CustomLineCap da enumeração LineCap existente especificada com a estrutura de tópicos e o preenchimento especificados. |
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) |
Inicializa uma nova instância da classe CustomLineCap da enumeração LineCap existente especificada com a estrutura de tópicos, o preenchimento e a inserção. |
Propriedades
BaseCap |
Obtém ou define a enumeração LineCap em que esse CustomLineCap se baseia. |
BaseInset |
Obtém ou define a distância entre o limite e a linha. |
StrokeJoin |
Obtém ou define a enumeração LineJoin que determina como as linhas que compõem esse objeto CustomLineCap são unidas. |
WidthScale |
Obtém ou define a quantidade pela qual escalar esse objeto de classe CustomLineCap em relação à largura do objeto Pen. |
Métodos
Clone() |
Cria uma cópia exata deste CustomLineCap. |
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 esse objeto CustomLineCap. |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo CustomLineCap e opcionalmente libera os recursos gerenciados. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
Finalize() |
Permite que um CustomLineCap tente liberar recursos e executar outras operações de limpeza antes que CustomLineCap seja 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 ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
GetStrokeCaps(LineCap, LineCap) |
Obtém os limites usados para iniciar e encerrar as linhas que compõem esse limite personalizado. |
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 para essa instância. (Herdado de MarshalByRefObject) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
SetStrokeCaps(LineCap, LineCap) |
Define os limites usados para iniciar e encerrar as linhas que compõem esse limite personalizado. |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |