Applies the "on" color to the selected text, or retrieves the current font color setting.
Syntax
AttributeTextOnColourEx(TextColour)
TextColour:
An RGB value.
Return Value
If retrieving the current font color, an RGB value. If applying a particular font color, 0 (zero) if successful. In both cases, an error is returned if unsuccessful. If values are out of range on writing to the attribute, the function exits and reports the error E_INVALIDARG. If there is no active text object, these functions throw an exception with a return value of E_HANDLE.
Note: For details on handling return and error values, see Error Handling.
Related Functions
AttributeText, AttributeTextStyle, AttributeTextJustification, AttributeTextFont, AttributeTextFontSize
Example
' Applies a color to the selected text
GraphicsBuilder.AttributeTextOnColourEx = &hFF0000
`Retrieves the current font color setting
MyVariable = GraphicsBuilder.AttributeTextOnColourEx
This function is implemented in the C++ environment as two separate functions: put_AttributeTextOnColourEx applies a color to the currently selected text, and get_AttributeTextOnColourEx retrieves the current text color.
Published June 2018