#include <Script.h> Script Manager

short TruncString( width, theString,truncWhere );

short width ; specified pixel width for the text string

Str255 theString ; text string

TruncCode truncWhere ; position in the text string to perform truncation

returns a short specifying the new string length

TruncString ensures that a string supplied as an Str255 fits into the

specified width by truncating the string, if necessary, in a manner dependent

smTruncErr (-1) General error (At present, this only occurs if

resNotFound (-192) Cannot get the correct 'itl4' resource or

Notes: The string truncation function ensure that a text string fits into the pixel

width specified by the width parameter and then truncates the string, when

necessary. These functions use the font script to determine how to perform

truncation. If truncation occurs, they also insert a truncation indicator

The truncWhere parameter specifies whether truncation occurs at the end

of the string or in the middle (the latter is useful for path names, for

example). Specify the constant smTruncEnd to truncate the string at the

end. Specify the constant smTruncMiddle to truncate the string in the

middle. In the TruncString function, the string is supplied as Str255. If

truncation occurs, the string length is updated to reflect the new length. If

general errors occur, the result code is smTruncErr and the length is set to

With System 7.0, a new token type, tokenEllipsis, has been defined; the

TruncString and TruncText functions obtain the corresponding

character from the untoken table in the 'itl4' resource. See

Script Manager Data and Macintosh Worldwide Development: Guide to

System Software for more information on the 'itl4' tables and related data

structures.The TruncString and TruncText functions are implemented

by the Script Manager itself, not by script systems. Both text truncation