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 |