# TextControlEx

TextControlEx()

Syntax

WindowsID = TextControlEx(Window.i, ID.l, X, Y, Width.l, Height.l, Text\$, Flags.l)

Description

Displays a text label (transparent by default) in the specified Window.

ID specifies the internal ID of the text label and if #ProGUI_Any is used then the returned value will be the new TextControlEx ID. X, Y, Width and Height are the position and dimensions of the label in the window. If Width or Height are null then the corresponding dimensions are calculated automatically. Text\$ specifies what is displayed in the label. Flags can include the following:

 Flag Description #TCX_BK_FILL background is a solid fill. see SetTextControlExColour #TCX_BK_GRADIENT background is a gradient fill. see SetTextControlExGradient #TCX_CENTRE text is centered horizontally #TCX_RIGHT text is right aligned #TCX_VCENTRE text is centered vertically #TCX_END_ELLIPSIS if the end of a line of text does not fit in the specified width/height dimensions, it is truncated and ellipses are added. #TCX_PATH_ELLIPSIS If a text line contains backslash ('\', escapecode: '\\') characters in a block (e.g. a file path), #TCX_PATH_ELLIPSIS preserves as much as possible of the text after the last backslash by replacing characters in the middle of the line with ellipses so that the result fits in the specified width/height dimensions. #TCX_DISABLE_ESCAPECODES disables processing and rendering of escape codes. #TCX_IGNORE_COLOR_ESCAPECODE ignores rendering of colour escape codes, useful for displaying all text as one colour for example, a disabled state.

Text\$ can also contain the following "escape code" effects: -