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.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.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.

  • Свойство RightToLeft не зависит от выравнивания кнопок панели инструментов в элементе управления ToolBar или выравнивания текста на ToolBarButton.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.

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

Дополнительно