Control.RightToLeft Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy elementy kontrolki są wyrównane do obsługi ustawień regionalnych przy użyciu czcionek od prawej do lewej.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

Wartość właściwości

Jedna z wartości RightToLeft.One of the RightToLeft values. Wartość domyślna to Inherit.The default is Inherit.

Wyjątki

Przypisana wartość nie jest jedną z wartości RightToLeft.The assigned value is not one of the RightToLeft values.

Uwagi

Właściwość RightToLeft jest właściwością otoczenia.The RightToLeft property is an ambient property. Właściwość otoczenia jest właściwością kontrolki, która jeśli nie jest ustawiona, zostanie pobrana z kontrolki nadrzędnej.An ambient property is a control property that, if not set, is retrieved from the parent control. Na przykład Button będzie mieć ten sam BackColor, jak Form nadrzędny, domyślnie.For example, a Button will have the same BackColor as its parent Form by default. Aby uzyskać więcej informacji o właściwościach otoczenia, zobacz klasy AmbientProperties lub klasy Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Właściwość RightToLeft jest używana w przypadku aplikacji międzynarodowych, w których język jest pisany od prawej do lewej, na przykład hebrajski lub arabski.The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. Gdy ta właściwość jest ustawiona na RightToLeft.Yes, elementy sterujące zawierające tekst są wyświetlane od prawej do lewej.When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.

Uwaga

Jeśli wartość właściwości RightToLeft jest zmieniana w czasie wykonywania, zachowywany jest tylko nieprzetworzony tekst bez formatowania.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Poniżej przedstawiono kilka przykładów, dla których ma wpływ RightToLeft wartość właściwości RightToLeft.Yes:The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • Pionowe paski przewijania są wyświetlane po lewej stronie, a nie po prawej stronie formantów przewijalnych (na przykład Form, Panel, wielowierszowy TextBoxi 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).

  • Poziome paski przewijania zaczynają się od pola przewijania, które jest wyrównane do prawej strony.Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • Wyrównanie elementu pola wyboru, kontrolowane przez właściwość CheckAlign, jest odwrócone dla kontrolek CheckBox i RadioButton.The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • Elementy w polu listy, polu kombi i kontrolki w górę są wyrównane do prawej.Items in list box, combo box, and up-down controls are right aligned.

  • Przyciski w górę i w dół są wyrównane do lewej strony NumericUpDown i DomainUpDown kontrolek.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • Menu (MainMenu, MenuItemi ContextMenu) są wyświetlane wyrównane do prawej.Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • Właściwość RightToLeft nie ma wpływ na wyrównanie przycisków paska narzędzi w formancie ToolBar ani wyrównanie tekstu na 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 obsługuje wyrównanie od prawej do lewej; jednak efekt na kontrolce ActiveX zależy od zakresu, w którym zaimplementowano autora kontrolki obsługującej Wyświetlanie od prawej do lewej.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.

Uwagi dotyczące dziedziczenia

Podczas zastępowania właściwości RightToLeft w klasie pochodnej należy użyć właściwości RightToLeft klasy bazowej, aby zwiększyć podstawową implementację.When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. W przeciwnym razie musisz podać wszystkie implementacje.Otherwise, you must provide all the implementation. Nie jest wymagane przesłonięcie zarówno get i set metod dostępu właściwości RightToLeft; w razie konieczności można przesłonić tylko jeden z nich.You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

Dotyczy

Zobacz też