Método Pen::SetDashCap (gdipluspen.h)

Artigo
08/24/2023

O método Pen::SetDashCap define o estilo de limite de traço para este objeto Pen .

Sintaxe

Status SetDashCap(
  [in] DashCap dashCap
);

Parâmetros

[in] dashCap

Tipo: DashCap

Elemento da enumeração DashCap que especifica a tampa do traço para este objeto Pen .

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Se você definir o alinhamento de um objeto Pen como PenAlignmentInset, não poderá usar essa caneta para desenhar tampas de traço triangulares.

Exemplos

O exemplo a seguir cria um objeto Pen , define o estilo do traço e a tampa do traço e desenha uma linha tracejada.

VOID Example_SetCustomStartCap(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a pen.
   Pen pen(Color(255, 0, 0, 255), 20);

   // Set the dash style for the pen.
   pen.SetDashStyle(DashStyleDash);

   // Set a triangular dash cap for the pen.
   pen.SetDashCap(DashCapTriangle);

   // Draw a line using the pen.
   graphics.DrawLine(&pen, 20, 20, 200, 100);
}

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdipluspen.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll