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

Artigo
02/29/2024

O método Pen::SetAlignment define o alinhamento desse objeto Pen em relação à linha.

Sintaxe

Status SetAlignment(
  [in] PenAlignment penAlignment
);

Parâmetros

[in] penAlignment

Tipo: PenAlignment

Elemento da enumeração PenAlignment que especifica a configuração de alinhamento da caneta em relação à linha desenhada. O valor padrão é PenAlignmentCenter.

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

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

Exemplos

O exemplo a seguir cria dois objetos Pen e define o alinhamento de uma das canetas. Em seguida, o código desenha duas linhas usando cada uma das canetas.

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

   // Create a black and a green pen.
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen greenPen(Color(255, 0, 255, 0), 15);

   // Set the alignment of the green pen.
   greenPen.SetAlignment(PenAlignmentInset);

   // Draw two lines using each pen.
   graphics.DrawEllipse(&greenPen, 0, 0, 100, 200);
   graphics.DrawEllipse(&blackPen, 0, 0, 100, 200);
}

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