IN_GetToolAttribute

All Editions $image\bltlrgsq_shg.gif$ Related Functions $image\bltlrgsq_shg.gif$ Example

Tools are used to draw vector objects on edit layers. You can assign tool attributes (line or frame width, color, line style, arrowhead style, font, and so on) to each edit layer or you can assign default attributes to be used on future edit layers. The IN_GetToolAttribute function returns the value of a specific attribute for the specified tool for either:

· the identified edit layer (equivalent of Tool Options in the user interface)

· the future edit layers (equivalent of Tool Preferences in the user interface)

Syntax

int IN_GetToolAttribute( objectID, toolID, attributeID, maxSize, pValue )

Input Parameters	Values	Meaning
IN_OBJECT objectID	layerID	identifier of the edit layer to query
	IN_SYSTEM_OBJECT (-1)	find the default value of the tool for future edit layers
SHORT toolID	IN_TOOL_*	identifier of the tool to query. You cannot query the Symbol tool.
SHORT attributeID	Tool attribute number	identifier of the attribute to query
SHORT maxSize	the maximum size of the pValue array
Output Parameters	Values	Meaning
CHARPTR pValue	Tool attribute values	value of attributeID. Numeric values are returned as ASCII text.

Release information

Added to Imagenation for Windows in Release 6.0.

Not yet available in Imagenation for UNIX.

See also

Activating tools

Defining tools