[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME
	IntuiTextLength -- Return the length (pixel-width) of an IntuiText.

    SYNOPSIS
	Length = IntuiTextLength( IText )
	D0                        A0

	LONG IntuiTextLength( struct IntuiText * );

    FUNCTION
	This routine accepts a pointer to an instance of an IntuiText structure,
	and returns the length (the pixel-width) of the string which that
	instance of the structure represents.

	NOTE: if the Font pointer of your IntuiText structure is set to NULL,
	you'll get the pixel-width of your text in terms of the current system
	default font.  You may wish to be sure that the field IText->ITextFont
	for 'default font' text is equal to the Font field of the screen it is
	being measured for.

    INPUTS
	IText = pointer to an instance of an IntuiText structure

    RESULT
	Returns the pixel-width of the text specified by the IntuiText data

    BUGS
	Would do better to take a RastPort as argument, so that a NULL in
	the Font pointer would lead automatically to the font for the
	intended target RastPort, rather than the system default font.

    SEE ALSO
	OpenScreen()