void SetTextCelFormatFlags (TextCel *tCel, uint32 formatFlags)
The formatFlags parameter contains one or more formatting options, ORed together. Available options are:
TC_FORMAT_LEFT_JUSTIFY-left-justify text
TC_FORMAT_RIGHT_JUSTIFY-right-justify text
TC_FORMAT_CENTER_JUSTIFY-center-justify text
TC_FORMAT_WORDWRAP-auto-word-wrap text
Changing the formatting options does not affect pixels already in the cel. You can make a series of calls to UpdateTextInCel()
with the replaceExisting flag set to FALSE, intermixed with calls to SetTextCelFormatFlags()
. This allows you to create, for example, a paragraph of word-wrapped text, followed by a line of centered text, followed by another word-wrapped paragraph. Turning word wrap on and off at locations other than a paragraph boundary might produce undesirable results. Word wrapping should only be changed immediately following a newline.