Control.RightToLeft Propriété

Définition

Obtient ou définit une valeur indiquant si les éléments du contrôle sont alignés pour prendre en charge les paramètres régionaux utilisant des polices de droite à gauche.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

Valeur de propriété

Une des valeurs de RightToLeft.One of the RightToLeft values. La valeur par défaut est Inherit.The default is Inherit.

Exceptions

La valeur assignée ne fait pas partie des valeurs RightToLeft.The assigned value is not one of the RightToLeft values.

Remarques

La propriété RightToLeft est une propriété ambiante.The RightToLeft property is an ambient property. Une propriété ambiante est une propriété de contrôle qui, si elle n’est pas définie, est récupérée à partir du contrôle parent.An ambient property is a control property that, if not set, is retrieved from the parent control. Par exemple, un Button aura le même BackColor que son parent Form par défaut.For example, a Button will have the same BackColor as its parent Form by default. Pour plus d’informations sur les propriétés ambiantes, consultez la classe AmbientProperties ou la vue d’ensemble de la classe Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

La propriété RightToLeft est utilisée pour les applications internationales où la langue est écrite de droite à gauche, par exemple l’hébreu ou l’arabe.The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. Quand cette propriété a la valeur RightToLeft.Yes, les éléments de contrôle qui incluent du texte sont affichés de droite à gauche.When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.

Notes

Si la valeur de la propriété RightToLeft est modifiée au moment de l’exécution, seul le texte brut sans mise en forme est conservé.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Voici quelques exemples de la façon dont les éléments de contrôle sont affectés par la valeur de propriété RightToLeft de RightToLeft.Yes :The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • Les barres de défilement verticales sont affichées sur le côté gauche plutôt que sur le côté droit des contrôles à défilement (par exemple, Form, Panel, multiligne TextBox et 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).

  • Les barres de défilement horizontales commencent par la case de défilement (Thumb) alignée à droite.Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • L’alignement de l’élément de case à cocher, contrôlé par la propriété CheckAlign, est inversé pour les contrôles CheckBox et RadioButton.The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • Les éléments de la zone de liste, de la zone de liste déroulante et des contrôles Up-Up sont alignés à droite.Items in list box, combo box, and up-down controls are right aligned.

  • Les boutons monter et descendre sont alignés à gauche sur les contrôles NumericUpDown et DomainUpDown.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • Les menus (MainMenu, MenuItem et ContextMenu) sont affichés alignés à droite.Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • L’alignement des boutons de la barre d’outils sur un contrôle ToolBar ou l’alignement du texte sur un ToolBarButton n’est pas affecté par la propriété 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 prend en charge l’alignement de droite à gauche ; Toutefois, l’effet sur un contrôle ActiveX dépend de la portée à laquelle l’auteur du contrôle a implémenté la prise en charge de l’affichage de droite à gauche.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.

Notes pour les héritiers

Lors de la substitution de la propriété RightToLeft dans une classe dérivée, utilisez la propriété RightToLeft de la classe de base pour étendre l’implémentation de base.When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. Sinon, vous devez fournir toute l’implémentation.Otherwise, you must provide all the implementation. Vous n’êtes pas tenu de substituer les deux accesseurs get et set de la propriété RightToLeft ; vous ne pouvez substituer qu’un seul si nécessaire.You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

S’applique à

Voir aussi