Generic Function | Package: cg | ToC | DocOverview | CGDoc | RelNotes | FAQ | Index | PermutedIndex
| Allegro CL version 9.0 Unrevised from 8.2 to 9.0. 8.2 version

## single-line

Arguments: tab-control

Returns the value of the single-line property of the argument. This property determines whether tabs on the `tab-control` widget will display in a single unbroken line or whether they wrap into several rows to display all at once in the window.

The single-line 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 :single-line 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 possible values and their effects are:

- `nil`: tabs are arranged into as many rows deep as needed to fit all of the tabs at once along the uppermost portion of the control. All tabs are visible all the time.
- `t`: tabs all appear in a single line across the `tab-control` control's top edge. A horizontal scroll bar appears at the right corner when there is not enough room to show all tabs in a single line.

single-line is a property of the `tab-control` class.

### GTK Note

The GTK `tab-control` always uses a single row of tabs, and specifying the single-line property will have no effect. You can scroll a tab-control quickly by holding the mouse button down on the scroll arrow, but only if the widget's focus-on-click property is true, since otherwise Common Graphics will move the keyboard focus to a widget on a tab. If it is tedious to scroll to all of the tabs, you might consider using a `multi-picture-button` instead, as we did for the IDE's Class Browser.

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 Unrevised from 8.2 to 9.0. 8.2 version