ContainerUserLookAndFeel.TouchUIMode Property

Gets or sets whether the current container and its child controls use touch UI mode, in which the controls automatically increase their size and the distance between some of their elements.

Namespace: DevExpress.LookAndFeel.Helpers

Assembly: DevExpress.Utils.v20.1.dll

Declaration

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public virtual DefaultBoolean TouchUIMode { get; set; }
<DefaultValue(DefaultBoolean.Default)>
<DXCategory("Appearance")>
Public Overridable Property TouchUIMode As DefaultBoolean

Property Value

Type Default Description
DefaultBoolean

Default

A value that specifies if touch UI mode is enabled for the current container and its child controls.

Remarks

In touch UI mode, controls automatically increase their size and the distance between some of their elements. The size and distance are increased according to the TouchScaleFactor setting.

To enable touch UI mode and set the touch scale factor for all forms within your application, use the WindowsFormsSettings.TouchUIMode and WindowsFormsSettings.TouchScaleFactor static settings. The ContainerUserLookAndFeel.TouchUIMode and ContainerUserLookAndFeel.TouchScaleFactor properties come in handy when you need to affect touch UI mode for individual forms/containers.

The following images show two XtraForms with touch UI mode disabled and enabled, respectively.

TouchUIMode=False TouchUIMode=True
XtraForm-TouchUIMode-False XtraForm-TouchUIMode-True

Note the increased size and padding of the form's elements and child controls in touch UI mode.

If the TouchUIMode property is set to Default, the touch UI mode availability is controlled by the WindowsFormsSettings.TouchUIMode global setting.

The ContainerUserLookAndFeel.TouchUIMode property is not in effect for certain controls and components residing in the XtraBars library that are managed by Bar And Docking Controllers. They include:

Touch UI mode for these controls/components can be enabled/disabled as follows:

See Also