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

AttributeShadowOnColourEx

Sets the shadow color when a shadowed 3D effect is used, or retrieves the current shadow color setting.

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

AttributeShadowOnColourEx(ShadowColour)

ShadowColour:

An RGB value.

Return Value

If retrieving the current shadow color setting, an RGB value. If applying a shadow 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 will exit and report the error E_INVALIDARG. If there is no active object, they will exit and report a return value of E_HANDLE.

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

Related Functions

Attribute3dEffects, Attribute3dEffectDepth, AttributeHiLightOffColourEx, AttributeHiLightOnColourEx, AttributeLoLightOffColourEx, AttributeLoLightOnColourEx

Example

' Applies a shadow color to a shadowed 3D effect
GraphicsBuilder.AttributeShadowOnColourEx = &hFF0000

' Retrieves the current shadow color
MyVariable = GraphicsBuilder.AttributeShadowOnColourEx

This function is implemented in the C++ environment as two separate functions: put_AttributeShadowOnColourEx applies a shadow color setting, and get_AttributeShadowOnColourEx retrieves the current shadow color setting.

Published June 2018