Control.RightToLeft Eigenschaft

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 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. Eine Ambient-Eigenschaft ist eine Steuerelement Eigenschaft, die, wenn Sie nicht festgelegt ist, vom übergeordneten Steuerelement abgerufen wird.An ambient property is a control property that, if not set, is retrieved from the parent control. Beispielsweise hat die Button standardmäßig dieselbe BackColor wie Ihr übergeordnetes Form.For example, a Button will have the same BackColor as its parent Form by default. Weitere Informationen zu Ambient-Eigenschaften finden Sie in der AmbientProperties-Klasse oder in der Übersicht über die Control-Klasse.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Die RightToLeft-Eigenschaft wird für internationale Anwendungen verwendet, bei denen die Sprache von rechts nach links geschrieben wird, z. b. Hebräisch oder Arabisch.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 RightToLeft.Yes festgelegt ist, werden Steuerelemente, die Text enthalten, 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 der RightToLeft-Eigenschaft zur Laufzeit geändert wird, wird nur unformatierter Text ohne Formatierung beibehalten.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Im folgenden finden Sie einige Beispiele dafür, wie Steuerelemente vom RightToLeft-Eigenschafts Wert RightToLeft.Yes beeinflusst werden:The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • Vertikale Schiebe leisten werden auf der linken Seite und nicht auf der rechten Seite der scrollbaren Steuerelemente angezeigt (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 Schiebe leisten beginnen mit dem rechtsbündig ausgerichteten Bild Lauf Feld (Ziehpunkt).Horizontal scroll bars start with the scroll box (thumb) right-aligned.

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

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

  • Die Schaltflächen "nach oben" und "nach unten" werden auf NumericUpDown-und DomainUpDown-SteuerelementenUp and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

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

  • Die Ausrichtung von Symbolleisten-Schaltflächen in einem ToolBar-Steuerelement oder die Ausrichtung von Text auf einem ToolBarButton wird von der RightToLeft-Eigenschaft nicht beeinflusst.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. die Auswirkung auf ein ActiveX-Steuerelement hängt jedoch davon ab, in welchem Umfang der Autor des Steuer Elements die Unterstützung für die Anzeige von rechts nach links implementiert hat.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

Wenn Sie die RightToLeft-Eigenschaft in einer abgeleiteten Klasse überschreiben, verwenden Sie die RightToLeft-Eigenschaft der Basisklasse, um die Basis 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. Es ist nicht erforderlich, die get-und set-Accessoren der RightToLeft-Eigenschaft zu überschreiben. Sie können bei Bedarf nur eine ü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