Aug 94

COLJUST.DLL - Right-justify, left-justify, or center selected text

Copyright (C) 1994 by Premia Corporation.  All rights reserved.

This package provides a way to adjust text formatting for columns
as well as whole lines.  The routines provided here can left-justify,
right-justify, or center.  They can operate on line, stream, or column
selections.  They can optionally handle selections containing tabs.

In the case of a stream or line selection, each line that is part
of the selection gets justified.  The left edge is always column 1.
The right edge is the visible margin mark, if there is one.  Otherwise,
the wrap margin is used.

In the case of a column selection, only the text in the selection
gets justified.  The left and right bounds of the selection
are used for the reference points.

If no text is selected, the entire current line gets adjusted.

Each of these functions takes a single boolean argument.  If this
argument is TRUE, then the function will attempt to handle tabs
correctly.  It will navigate the line by reckoning columns rather
than characters.  If the argument is FALSE, the routines assume
that each character takes up exactly one column.  This assumption
allows some greatly time-saving optimizations.  If no argument is
given, the selection is scanned for the presence of tabs, and the
parameter is set accordingly.

	
This DLL adds three API calls:

void ColCenter(BOOL dealWithTabs)

	Centers selected text.
	
	If the selection is a column selection, the text in the selection
	will be centered with respect to the left and right bounds of the
	selection.
	
	Line and stream selections will be centered between column 1 and the
	right margin mark, if one is set.  If there is no right margin mark,
	the wrap margin is used.
	
	If no text is selected, the current line is centered.
	
	If the selection contains or abuts tabs, then you should give
	an argument of TRUE to this function.  Otherwise, let the
	argument be FALSE for the sake of faster operation.
	
	
void ColRightJustify(BOOL dealWithTabs)

	Aligns text so that the right edge of each piece of text
	touches the right edge.  
	
	Column selections will be aligned to the right edge of the
	selection.
	
	Line and stream selections will be aligned to the right margin mark,
	If there is no right margin mark, the wrap margin is used.


void ColLeftJustify(BOOL dealWithTabs)

	Aligns text so that the left edge of each piece of text touches
	column 1.



To use this library, copy the file COLJUST.DLL to your Codewright
installation directory, and add the following line to the LibPreload
section of your CWRIGHT.INI file:

	LibPreload=coljust
	
Then restart Codewright.


