Pen::SetAlignment method (gdipluspen.h)

The Pen::SetAlignment method sets the alignment for this Pen object relative to the line.

Syntax

Status SetAlignment(
  [in] PenAlignment penAlignment
);

Parameters

[in] penAlignment

Type: PenAlignment

Element of the PenAlignment enumeration that specifies the alignment setting of the pen relative to the line that is drawn. The default value is PenAlignmentCenter.

Return value

Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

If you set the alignment of a Pen object to PenAlignmentInset, you cannot use that pen to draw compound lines or triangular dash caps.

Examples

The following example creates two Pen objects and sets the alignment for one of the pens. The code then draws two lines using each of the pens.

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);
}

Requirements

See also

Pen

Pen::GetAlignment

PenAlignment

Pens, Lines, and Rectangles

Setting Pen Width and Alignment