Applies to
Application and Window objects, and CheckBox, DataWindow, DatePicker, DropDownListBox, DropDownPictureListBox, EditMask, GroupBox, InkEdit, ListBox, ListView, MonthCalendar, MultiLineEdit, PictureListBox, RadioButton, RichTextEdit, SingleLineEdit, StaticHyperLink, StaticText, and TreeView controls
Description
The RightToLeft property specifies that characters should be displayed in right-to-left order. The application must be running on an operating system that supports right-to-left display. Values are:
-
TRUE -- Characters display in right-to-left order.
-
FALSE -- Characters display in left-to-right order (default).
When you want to display Arabic or Hebrew text for message and buttons, set the RightToLeft property of the Application object to true. The characters of the message display from right to left. However, the button text continues to display in English unless you are running a localized version of PowerBuilder.
For RichTextEdit controls, RichText DataWindow objects, and RichText edit style columns, this property not only has effect on the characters, but also the control's layout. In the RichTextEdit control and the RichText DataWindow object, RightToLeft = true will insert characters in the right-to-left order in the text editor, and display the layout right justified in the toolbar, status bar, ruler, popup menus, and dialog box. In the RichText edit style column, RightToLeft = true will insert characters in the right-to-left order in the active cell, and display the layout right justified in the toolbar for the current column.
For the other controls, this property has no effect on other aspects of the control's layout. For ListView and TreeView controls, use the LayoutRTL property to display a mirror image of the standard layout.
For best results, set this property in the painter so that you can see its effect. Setting this property at runtime can have unexpected results.
For the TreeView DataWindow style, this property can be set in the development environment but it cannot be set at runtime.
Usage
In a painter
To set the RightToLeft property:
-
Select the RightToLeft check box on the General page in the control's Properties view.
In scripts
The RightToLeft property takes a boolean value.
The following line sets the RightToLeft property of a SingleLineEdit control to true:
sle_1.RightToLeft = TRUE
