Trimming Enum

List values that specify how the characters in a string that do not completely fit into a layout shape are trimmed.

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v18.1.dll

Declaration

C#

[TypeConverter(typeof(EnumTypeConverter))]
[ResourceFinder(typeof(ResFinder), "PropertyNamesRes")]
public enum Trimming

VB.NET

<TypeConverter(GetType(EnumTypeConverter))>
<ResourceFinder(GetType(ResFinder), "PropertyNamesRes")>
Public Enum Trimming

Members

Name	Description
Default	Trimming is determined by a control’s current settings. The default value is automatically set for a control if an end-user doesn’t specify a value.
None	Specifies no trimming.
Character	Specifies that the text is trimmed to the nearest character.
Word	Specifies that text is trimmed to the nearest word.
EllipsisCharacter	Specifies that the text is trimmed to the nearest character, and an ellipsis is inserted at the end of a trimmed line.
EllipsisWord	Specifies that text is trimmed to the nearest word, and an ellipsis is inserted at the end of a trimmed line.
EllipsisPath	The center is removed from trimmed lines and replaced by an ellipsis. The algorithm keeps as much of the last slash-delimited segment of the line as possible.

Related API Members

The following properties accept/return Trimming values:

• TextOptions.Trimming

Remarks

These enumeration values are used to set the TextOptions.Trimming property.

Related GitHub Examples

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

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.

C#

custom-editor-how-to-create-a-custom-hyperlinkedit-with-the-autoheight-functionality-e3173/CS/WindowsApplication1/CustomEditor/MyHyperLinkEditPainter.cs#L14

{
    info.ViewInfo.PaintAppearance.TextOptions.Trimming = DevExpress.Utils.Trimming.None;
    base.DrawText(info);

how-to-create-a-buttonedit-descendant-that-can-show-a-multi-line-text-like-memoedit-e5150/CS/MultiLineButtonEdit.cs#L143

if(defaultEditTextOptions == null) {
    defaultEditTextOptions = new TextOptions(HorzAlignment.Near, VertAlignment.Top, WordWrap.Wrap, Trimming.None);
}

xtraform-how-to-center-align-a-header-caption-text-t103979/CS/WindowsApplication1/Custom Form Painter/CustomFormPainter.cs#L35

AppearanceObject appearance = new AppearanceObject(GetDefaultAppearance());
appearance.TextOptions.Trimming = Trimming.EllipsisCharacter;
appearance.TextOptions.HAlignment = CaptionAlignment;

VB.NET

custom-editor-how-to-create-a-custom-hyperlinkedit-with-the-autoheight-functionality-e3173/VB/WindowsApplication1/CustomEditor/MyHyperLinkEditPainter.vb#L12

Protected Overrides Sub DrawText(ByVal info As ControlGraphicsInfoArgs)
    info.ViewInfo.PaintAppearance.TextOptions.Trimming = DevExpress.Utils.Trimming.None
    MyBase.DrawText(info)

how-to-create-a-buttonedit-descendant-that-can-show-a-multi-line-text-like-memoedit-e5150/VB/MultiLineButtonEdit.vb#L195

If defaultEditTextOptions_Renamed Is Nothing Then
    defaultEditTextOptions_Renamed = New TextOptions(HorzAlignment.Near, VertAlignment.Top, WordWrap.Wrap, Trimming.None)
End If

xtraform-how-to-center-align-a-header-caption-text-t103979/VB/WindowsApplication1/Custom Form Painter/CustomFormPainter.vb#L37

Dim appearance As New AppearanceObject(GetDefaultAppearance())
appearance.TextOptions.Trimming = Trimming.EllipsisCharacter
appearance.TextOptions.HAlignment = CaptionAlignment