Version

Right-to-Left Support

Right-to-Left

Introduction

The Right-to-Left mode flips the control’s displayed text and UI elements across the line of symmetry, or axis of reflection, rendering a mirrored view of the control’s displayed text and UI elements, which usually displays in a Left-to-Right orientation. Some controls support Right-to-Left only on the UI elements while others support both, UI elements and the text.

As illustrated with WinCalendarCombo control below, the position of the text (Not the individual character positions) and the dropdown button are reversed when RightToLeft=Yes.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 1.png
Right to Left Support 2.png

The RightToLeft property has three options:

Option Description

No

Disables Right-to-Left (Default: Left-to-Right).

Yes

Enables Right-to-Left.

Inherit

Inherits the RightToLeft mode from the parent container, which can be the Form itself or another control.

If the Form is set with RightToLeft=Yes, every control on the form that has RightToLeft=Inherit will be overridden by the form’s setting.

Setting Right to Left mode

Support for the new Right-to-Left mode is now available through the control properties in Visual Studio designer and is fully configurable; alternatively you may do the same in code.

Configuring Right-to-Left through property grid.

Right to Left Support 3.png

Configuring Right-to-Left in code behind.

In C#:

WinCalendarCombo1.RightToLeft = RightToLeft.Yes;

In Visual Basic:

WinCalendarCombo1.RightToLeft = RightToLeft.Yes

Performance

The Right-to-Left mode raises performance concerns. Specifically, the implementation of this feature involves modifying the drawing methods at the framework level, and may lead to sacrificing some performance.

Supported Controls

WinButton

Supports Right-to-Left on a text caption and other elements such as a displayed icon. By default, the text is centered on the button. In the following example, it was changed to left justify for demonstrating the Right-to-Left mode.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 4.png
Right to Left Support 5.png

WinCalculatorDropDown

Supports Right-to-Left on the edit portion and the dropdown.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 6.png
Right to Left Support 7.png

WinCalendarCombo

Supports Right-to-Left on the edit portion (Date) and the dropdown button, but not the dropdown content.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 8.png
Right to Left Support 9.png

WinCheckEditor

Supports Right-to-Left on the text and the checkbox element.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 10.png
Right to Left Support 11.png

WinColorPicker

Supports Right-to-Left on the edit portion, the dropdown button and the dropdown.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 12.png
Right to Left Support 13.png

WinCombo

Supports Right-to-Left on the edit portion, the dropdown button, and the dropdown content.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 14.png
Right to Left Support 15.png

WinComboEditor

Supports Right-to-Left on the edit portion, the dropdown button and the dropdown content.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 16.png
Right to Left Support 17.png

WinCurrencyEditor

Supports Right-to-Left on elements such as a spin button but not the edit portion.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 18.png
Right to Left Support 19.png

WinDateTimeEditor

Supports Right-to-Left on the dropdown button, but not the edit portion of the displayed date.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 20.png
Right to Left Support 21.png

WinDockManager

Supports Right-to-Left for docked panes. Note, to opt-in, the form’s RightToLeft and RightToLeftLayout properties need to be set appropriately.

In C#

this.RightToLeft = RightToLeft.Yes;
this.RightToLeftLayout = true;

In VB

Me.RightToLeft = RightToLeft.Yes
Me.RightToLeftLayout = True
Left-to-Right Right-to-Left
Right to Left Support DockManager Left.png
Right to Left Support DockManager Right.png

WinDropDownButton

Supports Right-to-Left on the text caption and the dropdown button. By default, the text is centered on the button. In the following example, it was changed to left justify for demonstrating the Right-to-Left mode.

Left-to-Right Right-to-Left
Right to Left Support 22.png
Right to Left Support 23.png

WinFontNameEditor

Supports Right-to-Left on the edit portion, the dropdown button and the dropdown.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 24.png
Right to Left Support 25.png

WinFormattedLinkLabel

Supports Right-to-Left on the button element, but not the text.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 26.png
Right to Left Support 27.png

WinFormattedTextEditor

Supports Right-to-Left on the button element, but not the text.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 28.png
Right to Left Support 29.png

WinGrid

Supports Right-to-Left positioning of the columns and cell contents.

Left-to-Right (Default view) Right-to-Left
Right to Left Support Grid R.png
Right to Left Support Grid L.png

WinLabel

Supports Right-to-Left on the text box and any element added to the text box, such as a button or an icon.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 30.png
Right to Left Support 31.png

WinMaskedEdit

Supports Right-to-Left on elements such as a spin buttons, but not the edit portion that displays the value.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 32.png
Right to Left Support 33.png

WinNumericEditor

Supports Right-to-Left on elements such as a spin button, but not the edit portion that displays the numeric value.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 34.png
Right to Left Support 35.png

WinOptionSet

Supports Right-to-Left on the text and the radio button element.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 36.png
Right to Left Support 37.png

WinProgressBar

Supports Right-to-Left on the displayed text and the value portion of the progress (Green) indicator.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 38.png
Right to Left Support 39.png

WinScrollBar

Supports Right-to-Left on the thumb button.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 40.png
Right to Left Support 41.png

WinTabControl

Supports Right-to-Left on the tab control.

Left-to-Right (Default view) Right-to-Left
tabRTL 1.png
tabRTL 2.png

WinTabStripControl

Supports Right-to-Left on the tab strip control.

Left-to-Right (Default view) Right-to-Left
tabRTL 1.png
tabRTL 2.png

WinTextEditor

Supports Right-to-Left on the edit portion and any added element such as an icon.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 42.png
Right to Left Support 43.png

WinTimeSpanEditor

Supports Right-to-Left on the text and the spin button element.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 44.png
Right to Left Support 45.png

WinTimeZoneEditor

Supports Right-to-Left on the edit portion, the dropdown button, and the dropdown.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 46.png
Right to Left Support 47.png

WinTrackBar

Supports Right-to-Left on the thumb button and tick marks when the control is positioned as follows:

  • * Positioned horizontally – The thumb buttons appear mirrored.

  • * Positioned vertically – The thumb buttons and tick marks appear facing each-other.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 48.png
Right to Left Support 49.png
Right to Left Support 50.png
Right to Left Support 51.png

WinTree

Supports Right-to-Left on tree nodes.

Left-to-Right (Default view) Right-to-Left
Right to Left Support 52.png
Right to Left Support 53.png