Skip to main content

LabelControl.AutoSizeMode Property

Gets or sets the direction in which the label grows to display its entire contents.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(LabelAutoSizeMode.Default)]
[DXCategory("Layout")]
public LabelAutoSizeMode AutoSizeMode { get; set; }

Property Value

Type Default Description
LabelAutoSizeMode Default

The direction in which the label grows to display its entire contents.

Available values:

Name Description
Default

In Visual Studio 2002 and 2003, the same as the None option.

In Visual Studio 2005 and more recent versions, the same as the Horizontal option.

None

Disables the auto size mode. An end-user is allowed to change both the label’s width and height.

Horizontal

The label is automatically resized to display its entire contents horizontally. The label’s size depends only on the length of the text and the font settings, the label cannot be resized by an end-user.

Vertical

The label’s height is automatically changed to display its entire contents. In this instance, an end-user can change the label’s width while its height is automatically adjusted to fit the label’s text.

Remarks

If the AutoSizeMode property is set to LabelAutoSizeMode.Horizontal, the label automatically changes its width to display its entire contents. Its size depends only on the length of the text and on the font settings, the label cannot be resized by a user.

If the AutoSizeMode property is set to the LabelAutoSizeMode.Vertical value, the label automatically changes its height to display its entire contents. In this instance, a user can change the label’s width while its height automatically adjusts to fit the label’s text.

The code sample below illustrates a label control that grows horizontally until 300 pixels, after which it wraps the text to next line(s).

int nMaxWidth = 300;

labelControl1.AutoSizeMode = LabelAutoSizeMode.Vertical;
labelControl1.Width = nMaxWidth;
labelControl1.Text = "This is an example of a label control that stretches vertically to hold a long text.";

The following code snippets (auto-collected from DevExpress Examples) contain references to the AutoSizeMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also