Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version


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-2017, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2017.2.15.

Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version