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

AttributeEllipseStyle

Applies a style to an ellipse, or retrieves the current ellipse style 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

AttributeEllipseStyle(EllipseStyle)

EllipseStyle:

A value representing the current ellipse style.

Return Value

If retrieving the current ellipse style setting, a value between 0 and 2 representing one of three style options. If applying a style setting, 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 with a return value of E_HANDLE.

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

Example

' Applies a style (arc) to an ellipse
GraphicsBuilder.AttributeEllipseStyle = 2

' Retrieves a value representing the style applied to an ellipse
MyVariable = GraphicsBuilder.AttributeEllipseStyle

Note: This function is implemented in the C++ environment as two separate functions: put_AttributeEllipseStyle applies a style to an ellipse, and get_AttributeEllipseStyle retrieves the current ellipse style setting.