BarAndDockingControllerLookAndFeel.FormTouchUIMode Property

Gets or sets whether the touch UI mode is enabled for the controls managed by the current BarAndDockingController.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
public virtual DefaultBoolean FormTouchUIMode { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
Public Overridable Property FormTouchUIMode As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A value that specifies whether the touch UI mode is enabled for the controls managed by the current BarAndDockingController.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

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 UI scale factor for all forms within your application, use the WindowsFormsSettings.TouchUIMode and WindowsFormsSettings.TouchScaleFactor static settings.

To specify touch UI settings for the following controls within individual forms, the BarAndDockingControllerLookAndFeel.FormTouchUIMode and BarAndDockingControllerLookAndFeel.FormTouchScaleFactor properties can be used.

• Controls that manage the Ribbon UI (RibbonControl, RibbonStatusBar, BackstageViewControl, RibbonMiniToolbar, etc.).
• Bars and popup menus created with the BarManager component.
• Dock panels, created with the DockManager component.
• Application UI, created with the DocumentManager component.
• Native MDI, created with the XtraTabbedMdiManager component.

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

• Add a BarAndDockingController onto the form/user control.
• Ensure this BarAndDockingController is assigned to the target control/component via its Controller property (e.g., BarManager.Controller and RibbonControl.Controller).
• Set the BarAndDockingController‘s BarAndDockingControllerLookAndFeel.FormTouchUIMode property to the required value.
• Optionally, specify the BarAndDockingControllerLookAndFeel.FormTouchScaleFactor property.

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