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

RightToLeft

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

Wyjątki

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

Uwagi

RightToLeftWłaściwość 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 wartość a Button będzie taka sama BackColor jak jej element nadrzędny Form 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 AmbientProperties klasy lub Control Przegląd klas.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

RightToLeftWłaściwość 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ść RightToLeft właściwości 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 kontrolek przewijanych (na przykład,, Form Panel wielowierszowych TextBox i 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 CheckAlign Właściwość, jest odwrócone dla CheckBox i RadioButton kontrolki.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 są DomainUpDown kontrolkami.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

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

  • Właściwość nie ma wpływ na wyrównanie przycisków paska narzędzi na ToolBar kontrolce lub wyrównanie tekstu 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 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 RightToLeft właściwości w klasie pochodnej należy użyć właściwości klasy bazowej, RightToLeft 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 obu get metod i set dostępu do RightToLeft właściwości; w razie potrzeby można przesłonić tylko jeden.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ż