Compartilhar via


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

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

Sintaxe

Status SetDashStyle(
  [in] DashStyle dashStyle
);

Parâmetros

[in] dashStyle

Tipo: DashStyle

Elemento da enumeração DashStyle que especifica o estilo de traço para este objeto Pen .

Retornar valor

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

O comprimento dos traços em uma linha tracejada depende do estilo do traço e da largura do objeto Pen . O comprimento do espaço que separa dois traços em uma linha tracejada é igual à largura do objeto Pen .

Exemplos

O exemplo a seguir cria um objeto Pen , define o estilo do traço e desenha uma linha. Em seguida, o código redefine o estilo do traço, desenha uma segunda linha, redefine o estilo do traço novamente e desenha uma terceira linha.

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

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

   // Set the dash style for the pen, and draw a dashed line.
   pen.SetDashStyle(DashStyleDash);
   graphics.DrawLine(&pen, 0, 50, 400, 150);

   // Reset the dash style for the pen, and draw a second line.
   pen.SetDashStyle(DashStyleDot);
   graphics.DrawLine(&pen, 0, 80, 400, 180); 

   // Reset the dash style for the pen, and draw a third line.
   pen.SetDashStyle(DashStyleDashDot);
   graphics.DrawLine(&pen, 0, 110, 400, 210); 
}

Requisitos

Requisito Valor
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

Confira também

Desenhando uma linha tracejada personalizada

Caneta

Caneta::GetDashCap

Caneta::GetDashOffset

Caneta::GetDashPattern

Pen::GetDashPatternCount

Caneta::GetDashStyle

Pen::SetDashCap

Pen::SetDashOffset

Caneta::SetDashPattern

Canetas, linhas e retângulos