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

Definition

Ruft einen Wert ab, der angibt, ob Elemente des Steuerelements für die Unterstützung von Gebietsschemas ausgerichtet sind, die von rechts nach links geschriebene Schriftarten verwenden, oder legt diesen fest.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

Eigenschaftswert

Einer der RightToLeft-Werte.One of the RightToLeft values. Die Standardeinstellung ist Inherit.The default is Inherit.

Ausnahmen

Der zugewiesene Wert ist keiner der der RightToLeft Werte.The assigned value is not one of the RightToLeft values.

Hinweise

Die RightToLeft -Eigenschaft ist eine ambient-Eigenschaft.The RightToLeft property is an ambient property. Ambiente-Eigenschaft ist eine Eigenschaft des Steuerelements, dass, wenn Sie nicht festgelegt ist, wird vom übergeordneten Steuerelement abgerufen.An ambient property is a control property that, if not set, is retrieved from the parent control. Z. B. eine Button haben dieselbe BackColor als übergeordnetes Form standardmäßig.For example, a Button will have the same BackColor as its parent Form by default. Weitere Informationen zu ambient-Eigenschaften finden Sie unter den AmbientProperties Klasse oder die Control Übersicht über die Klasse.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Die RightToLeft Eigenschaft werden für internationale Anwendungen, in die Sprache von rechts nach links, z.B. Hebräisch oder Arabisch geschrieben wird.The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. Wenn diese Eigenschaft auf festgelegt ist RightToLeft.Yes, Steuerelemente, die Text enthalten, werden von rechts nach links angezeigt.When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.

Hinweis

Wenn der Wert des der RightToLeft Eigenschaft zur Laufzeit geändert wird, werden nur Text ohne Formatierung wird beibehalten.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Im folgenden sind einige Beispiele für wie Steuerelemente betroffen sind der RightToLeft Eigenschaftswert RightToLeft.Yes :The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • Vertikale Schiebeleisten auf der linken Seite statt auf der rechten Seite von bildlauffähigen Steuerelementen angezeigt werden (z. B. Form, Panel, mehrzeilige TextBox, und 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).

  • Horizontale Scrollleisten starten mit einem rechtsbündigen Bildlauffeld (Ziehpunkt).Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • Das Element Ausrichtung für Kontrollkästchen gesteuert wird, durch die CheckAlign -Eigenschaft wird für umgekehrt CheckBox und RadioButton Steuerelemente.The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • Elemente im Listenfeld, Kombinationsfeld und auf-ab-Steuerelemente sind rechtsbündig ausgerichtet.Items in list box, combo box, and up-down controls are right aligned.

  • Nach oben oder unten Schaltflächen sind linksbündig ausgerichtet auf NumericUpDown und DomainUpDown Steuerelemente.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • Menüs (MainMenu, MenuItem, und ContextMenu) rechtsbündig angezeigt werden.Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • Die Ausrichtung des Symbolleisten-Schaltflächen in eine ToolBar Steuerelement oder die Ausrichtung des Texts auf einem ToolBarButton ist nicht betroffen von der RightToLeft Eigenschaft.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 unterstützt die Ausrichtung von rechts-nach-links. Allerdings hängt die Auswirkungen auf ein ActiveX-Steuerelement das Ausmaß, in dem der Autor des Steuerelements implementiert wird Unterstützung für die Anzeige von rechts-nach-links.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.

Hinweise für Vererber

Beim Überschreiben der RightToLeft Eigenschaft in einer abgeleiteten Klasse verwenden, der Basisklasse RightToLeft Eigenschaft, um die grundlegende Implementierung zu erweitern.When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. Andernfalls müssen Sie die gesamte Implementierung bereitstellen.Otherwise, you must provide all the implementation. Sie müssen nicht beide außer Kraft setzen der get und set Accessoren der der RightToLeft Eigenschaft; Sie können nur eine bei Bedarf überschreiben.You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

Gilt für:

Siehe auch