CDC::GetTextAlign

Syntax

UINT GetTextAlign() const;

Remarks

Retrieves the status of the text-alignment flags for the device context.

The text-alignment flags determine how TextOut and ExtTextOut align a string of text in relation to the string's starting point. The text-alignment flags are not necessarily single-bit flags and may be equal to 0. To test whether a flag is set, an application should follow these steps:

1.Apply the bitwise-OR operator to the flag and its related flags. The following list shows the groups of related flags:

TA_LEFT, TA_CENTER, and TA_RIGHT

TA_BASELINE, TA_BOTTOM, and TA_TOP

TA_NOUPDATECP and TA_UPDATECP

2.Apply the bitwise AND operator to the result and the return value.

3.Test for the equality of this result and the flag.

Return Value

The status of the text-alignment flags. The return value is one or more of the following values:

Value

Meaning

TA_BASELINE	Specifies alignment of the x-axis and the baseline of the chosen font within the bounding rectangle.
TA_BOTTOM	Specifies alignment of the x-axis and the bottom of the bounding rectangle.
TA_CENTER	Specifies alignment of the y-axis and the center of the bounding rectangle.
TA_LEFT	Specifies alignment of the y-axis and the left side of the bounding rectangle.
TA_NOUPDATECP	Specifies that the current position is not updated.
TA_RIGHT	Specifies alignment of the y-axis and the right side of the bounding rectangle.
TA_TOP	Specifies alignment of the x-axis and the top of the bounding rectangle.
TA_UPDATECP	Specifies that the current position is updated.