Método Pen::SetDashOffset (gdipluspen.h)
O método Pen::SetDashOffset define a distância do início da linha até o início do primeiro traço em uma linha tracejada.
Sintaxe
Status SetDashOffset(
[in] REAL dashOffset
);
Parâmetros
[in] dashOffset
Tipo: REAL
Número real que especifica o número de vezes para deslocar os espaços em uma linha tracejada. Cada deslocamento é igual ao comprimento de um espaço na linha tracejada.
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
Um valor dashOffset positivo desloca o primeiro traço para frente ao longo do caminho, e um valor dashOffset negativo desloca o início do caminho para a frente ao longo do primeiro traço.
Exemplos
O exemplo a seguir cria um objeto Pen , define o estilo do traço e desenha uma linha. Em seguida, o código define o valor de deslocamento da caneta e desenha uma segunda linha.
VOID Example_SetDashOffset(HDC hdc)
{
Graphics graphics(hdc);
// Create a Pen object, set the dash style, and draw a line.
Pen pen(Color(255, 0, 0, 255), 15);
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 50, 400, 50);
// Set the dash offset value for the pen, and draw a second line.
pen.SetDashOffset(10);
graphics.DrawLine(&pen, 0, 80, 400, 80);
}
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 |