justification

Arguments: standard-object

Returns (or sets with setf) how text will be positioned horizontally on object. The value should be one of the symbols :left, :center, or :right.

justification is a property of the list-view-column, header-info, editable-text (see note below), multi-line-editable-text, static-text, and (starting in release 7.0) button classes.

Note on editable-text: according to Microsoft, this option will work for a single-line text editing control (the editable-text in Common Graphics) only in Windows 98 or Windows 2000 or later. In Windows NT 4.0 the control will presumably remain left-justified, though we have observed alternate justification working in Windows NT 4.0 Service Pack 6.

Note on text-edit-panes: If object is an instance of text-edit-pane (such as a rich-edit-pane), justification returns the paragraph justification of the selected text of the argument. The possible values are :left, :center, or :right.

The justification property may not be changed on an existing control, and must instead be specified with the inspector when designing a control (using a form) or with the :resizable initarg of make-instance. (It can be changed using the inspector when designing a form but not for a running control, either in the IDE or in an application.)

The setf function for a text-edit-pane sets the paragraph justification of the selected text.

A text-edit-pane argument must be an instance of a text-edit-pane (which is a superclass of rich-edit-pane). It cannot be a text-edit-window or a rich-edit control (apply window to a rich-edit control to get a value suitable as an argument to this function).

See cg-rich-text.htm for information about rich text editing in Common Graphics.

Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. The object described on this page has been modified in the 7.0 release; see the Release Notes.
Created 2005.9.20.