Technical Reference > Graphics Builder Automation Interface > Object Drawing and Property Functions > AttributeGradientOffColour


Sets or retrieves the "Off" portion of the gradient color on the General| Appearance tab of the Object Properties dialog for the current object.

This is only supported on rectangle objects.




Off portion of the gradient color.

Return Value

If retrieving the gradient color, an RGB encoded color. If applying a gradient 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.