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.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(DefaultBoolean.Default)]
public virtual DefaultBoolean FormTouchUIMode { get; set; }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 | Return Value |
|---|---|---|
| True | The value is true. |
|
| False | The value is false. |
|
| Default | The value is specified by a global option or a higher-level object. |
|
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.