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

Artigo
02/26/2024

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