Control.RightToLeft Control.RightToLeft Control.RightToLeft Control.RightToLeft Property

Определение

Возвращает или задает значение, указывающее, выровнены ли компоненты элемента управления для поддержки языков, использующих шрифты с написанием справа налево.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многострочном 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.

  • Выравнивание кнопок панели инструментов на 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.

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

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