Generic Function | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Moderate update since 9.0 release. 8.2 version

## 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 `button` classes.

Note on editable-text on Windows: according to Microsoft, this option will work for a single-line text editing control (the `editable-text` in Common Graphics) only in 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 static-text on GTK: To use `:center` or `:right` justification in a static-text widget on Linux and a Mac, the wrapping property must be `nil`. If you want multiple lines of text, you can insert newline characters into the value string.

Note on text-edit-panes on Windows: 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 setf function for a `text-edit-pane` sets the paragraph justification of the selected text.

On Windows, 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.)

A text-edit-pane argument must be an instance of a `text-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-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.2 page.
Created 2012.5.30.

|  | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Moderate update since 9.0 release. 8.2 version