Control.RightToLeft Свойство

Определение

Возвращает или задает значение, указывающее, выровнены ли компоненты элемента управления для поддержки языков, использующих шрифты с написанием справа налево.Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

public:
 virtual property System::Windows::Forms::RightToLeft RightToLeft { System::Windows::Forms::RightToLeft get(); void set(System::Windows::Forms::RightToLeft value); };
public virtual System.Windows.Forms.RightToLeft RightToLeft { get; set; }
member this.RightToLeft : System.Windows.Forms.RightToLeft with get, set
Public Overridable Property RightToLeft As RightToLeft

Значение свойства

RightToLeft

Одно из значений перечисления RightToLeft.One of the RightToLeft values. Значение по умолчанию — Inherit.The default is Inherit.

Исключения

Присваиваемое значение не относится к значениям RightToLeft.The assigned value is not one of the RightToLeft values.

Комментарии

RightToLeftСвойство является внешним свойством.The RightToLeft property is an ambient property. Внешнее свойство — это свойство элемента управления, которое, если оно не задано, извлекается из родительского элемента управления.An ambient property is a control property that, if not set, is retrieved from the parent control. Например, Button по умолчанию объект будет иметь то же значение, BackColor что и его родительский элемент Form .For example, a Button will have the same BackColor as its parent Form by default. Дополнительные сведения о внешних свойствах см. в разделе AmbientProperties класс или Control Общие сведения о классе.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

RightToLeftСвойство используется для международных приложений, где язык написан справа налево, например иврит или арабский.The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. Если это свойство имеет значение RightToLeft.Yes , элементы управления, содержащие текст, отображаются справа налево.When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.

Примечание

Если значение RightToLeft свойства изменяется во время выполнения, сохраняется только необработанный текст без форматирования.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Ниже приведено несколько примеров того, как на элементы управления влияет RightToLeft значение свойства RightToLeft.Yes :The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • Вертикальные полосы прокрутки отображаются в левой части, а не в правой части прокручиваемых элементов управления (например,,, Form Panel Multiline TextBox и RichTextBox ).Vertical scroll bars are displayed on the left side rather than right side of scrollable controls (for example, Form, Panel, multiline TextBox, and RichTextBox).

  • Горизонтальные полосы прокрутки начинаются с полосы прокрутки (бегунка), расположенной по правому краю.Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • Элемент управления флажком, который управляется CheckAlign свойством, изменяется на противоположный для CheckBox и RadioButton Controls.The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • Элементы в списке, поле со списком и элементы управления "вверх-вниз" выводятся по правому краю.Items in list box, combo box, and up-down controls are right aligned.

  • Кнопки вверх и вниз выровнять по левому краю NumericUpDown для DomainUpDown элементов управления и.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • Меню ( MainMenu , MenuItem и ContextMenu ) отображаются по правому краю.Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • Свойство не влияет на выравнивание кнопок панели инструментов в ToolBar элементе управления или на выравнивание текста по отношению к нему ToolBarButton RightToLeft .The alignment of toolbar buttons on a ToolBar control or the alignment of text on a ToolBarButton is not affected by the RightToLeft property.

  • AxHost поддерживает выравнивание справа налево; Однако воздействие на элемент управления ActiveX зависит от степени, в которой автор элемента управления реализовал поддержку вывода справа налево.AxHost supports right-to-left alignment; however, the effect on an ActiveX control depends on the extent to which the control author implemented support for right-to-left display.

Примечания для тех, кто наследует этот метод

При переопределении RightToLeft свойства в производном классе используйте свойство базового класса RightToLeft для расширения базовой реализации.When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. В противном случае необходимо предоставить всю реализацию.Otherwise, you must provide all the implementation. Переопределение get методов доступа и для свойства не требуется set RightToLeft ; при необходимости можно переопределить только одно из них.You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

Применяется к

См. также раздел