A newer version of this page is available. Switch to the current version.

LabelControl.AutoSizeMode Property

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.2.dll

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.";
See Also