6.23 CADAddString

CADAddString adds a single line String to a drawing or a block.

IO	Parameter	Type	Description
in	theCADArea	longint	Area ID
in	theBlockID	longint	A Block ID or kCADRootBlockID for the root drawing
in	theLayerOrSubLayerID	longint	Layer ID or Sublayer ID
in	theString	Str255	The string, up to a maximum of 255 characters
in	theBaseX	real	The X-coordinate of the insertion point
in	theBaseY	real	The Y-coordinate of the unrotated base line
in	theRotation	real	The rotation Angle of the string
in	theMacFontStr	Str255	A Font string, to be used on Macintosh
in	theDosFontStr	Str255	A Font string, to be used on Windows
in	theFontSize	real	A fontsize, expressed in 4D CAD Units (not in points)
in	theFontStyle	integer	A mask of font style constants
in	theJustification	integer	A string justification constant
in	theStringColor	longint	Color or a color constant
out	theNewObjID	longint	Object ID of the new object
out	function result	OSErr	Error result code, also see Error handling

Remarks
If the string contains a LineFeed or Carriage Return character, error kCADFoundCRorLFInString is returned.

Related methods
CADObjString, CADGetString, CADSetString, CADGetStringXY, CADSetStringXY, CADGetFont, CADSetFont, CADStringBounds.