Extensibility > Graphics Builder Automation Interface > Object Drawing and Property Functions > AttributeLineOffColourEx

AttributeLineOffColourEx

Applies a color to a line, or retrieves the current "off" color setting. The function uses RGB colors for each state of a color instead of a palette index.

This function applies to the selected object, which is typically the last placed object. By using the PageSelectFirstObject() and PageSelectNextObject() functions, you can access your objects, and change or read their properties.

Syntax

AttributeLineOffColourEx(LineColour)

LineColour:

An RGB value.

Return Value

If retrieving the current line color, an RGB value. If setting the line 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 object, they exit and report a return value of E_HANDLE.

Note: For details on handling return and error values, see Error Handling.

Related Functions

AttributeLineWidth, AttributeLineStyle

Example

' Applies a color to the current line
GraphicsBuilder.AttributeLineOffColourEx = &hFF0000

' Retrieves the value of the color applied to the current line
MyVariable = GraphicsBuilder.AttributeLineOffColourEx

This function is implemented in the C++ environment as two separate functions: put_AttributeLineOffColourEx applies a particular color to a line, and get_AttributeLineOffColourEx retrieves the current color setting.

Published June 2018