TextOptions.Trimming Property

Gets or sets text trimming mode.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v20.1.dll

Declaration

[DefaultValue(Trimming.Default)]
[XtraSerializableProperty]
public virtual Trimming Trimming { get; set; }
<DefaultValue(Trimming.Default)>
<XtraSerializableProperty>
Public Overridable Property Trimming As Trimming

Property Value

Type Default Description
Trimming

Default

A Trimming value that specifies text trimming mode.

Property Paths

You can access this nested property as listed below:

Object Type Path to Trimming
AppearanceObject
.TextOptions.Trimming
AppearanceObjectEx
.TextOptions.Trimming
DiagramAppearanceObject
.TextOptions.Trimming
HyperlinkLabelControlAppearanceObject
.TextOptions.Trimming
LabelControlAppearanceObject
.TextOptions.Trimming

Remarks

The Trimming property specifies how the characters are trimmed in a string that does not completely fit into the container. See the Trimming topic for a list of available options.

When an AppearanceObject's style setting (for example, BackColor, ForeColor, Font and TextOptions.HAlignment) is set to a non-default value, the corresponding Options.Use... option (for instance, Options.UseBackColor, Options.UseForeColor, Options.UseFont and Options.UseTextOptions) is automatically set to true in the following cases:

  • The AppearanceObject belongs to a control/component (or its element), and this control/component has been completely loaded (see the control's IsLoading property to check the load status);
  • The AppearanceObject belongs to a grid column/band or tree list column/band, and the column/band belongs to a grid/tree list control;
  • The AppearanceObject is standalone, that is, it does not belong to any control or component.

In other cases, the Options.Use... options are not automatically enabled. You may need to enable these options manually for the style settings to be in effect.

The code sample below illustrates how to trim long strings in a grid with an ellipsis.

WinExplorerView - Context Button Types


gridView1.Columns["productName"].AppearanceCell.TextOptions.Trimming = Trimming.EllipsisPath;
See Also