Skip to main content

AppearanceObject.TextOptions Property

Provides access to text rendering options (horizontal and vertical alignment, word wrapping, trimming options, etc.).

Namespace: DevExpress.Utils

Assembly: DevExpress.Utils.v24.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

[Browsable(true)]
[XtraSerializableProperty(XtraSerializationVisibility.Content, XtraSerializationFlags.DefaultValue)]
[DXCategory("Font")]
public virtual TextOptions TextOptions { get; }

Property Value

Type Description
TextOptions

A TextOptions object containing text options.

Remarks

The object returned provides a set of Boolean properties specifying the current appearance object’s text settings (horizontal and vertical alignment, word wrapping, trimming options, etc.).

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.

See Also