Control.RightToLeft プロパティ


コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

 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



RightToLeft 値のいずれか 1 つ。One of the RightToLeft values. 既定値は、Inherit です。The default is Inherit.


代入された値が、RightToLeft 値ではありません。The assigned value is not one of the RightToLeft values.


RightToLeftプロパティはアンビエントプロパティです。The RightToLeft property is an ambient property. アンビエントプロパティは、設定されていない場合、親コントロールから取得されるコントロールプロパティです。An ambient property is a control property that, if not set, is retrieved from the parent control. たとえば、既定では、は Button BackColor その親と同じになり Form ます。For example, a Button will have the same BackColor as its parent Form by default. アンビエントプロパティの詳細については、 AmbientProperties クラスまたはクラスの概要に関するトピックを参照してください ControlFor more information about ambient properties, see the AmbientProperties class or the Control class overview.

プロパティは、 RightToLeft ヘブライ語やアラビア語など、言語が右から左に記述される国際対応アプリケーションに使用されます。The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. このプロパティがに設定されている場合 RightToLeft.Yes 、テキストを含むコントロール要素は右から左に表示されます。When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.


RightToLeft実行時にプロパティの値が変更された場合、書式設定のない未加工テキストのみが保持されます。If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

次に、のプロパティ値によってコントロール要素がどのように影響を受けるかを示す例をいくつか示し RightToLeft RightToLeft.Yes ます。The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • 垂直スクロールバーは、スクロール可能なコントロールの右側ではなく左側に表示されます (たとえば、、 Form Panel 、multiline TextBox 、および 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).

  • 水平スクロールバーは、スクロールボックス (つまみ) を右揃えで開始します。Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • プロパティによって制御されるチェックボックス要素の配置 CheckAlign は、およびコントロールに対して逆に CheckBox RadioButton なります。The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • リストボックス、コンボボックス、およびアップダウンコントロール内の項目は、右にアラインされます。Items in list box, combo box, and up-down controls are right aligned.

  • 上矢印ボタンと下矢印ボタンは、およびコントロールに対して左揃えになってい NumericUpDown DomainUpDown ます。Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • メニュー ( MainMenuMenuItem 、および ContextMenu ) は、右詰めで表示されます。Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • コントロール上のツールバーボタンまたはの ToolBar テキストの配置は、 ToolBarButton プロパティの影響を受けません RightToLeftThe alignment of toolbar buttons on a ToolBar control or the alignment of text on a ToolBarButton is not affected by the RightToLeft property.

  • AxHost 右から左への配置をサポートします。ただし、ActiveX コントロールへの影響は、コントロールの作成者が、右から左へ表示するためのサポートを実装した範囲によって異なります。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.

注意 (継承者)

派生クラスのプロパティをオーバーライドする場合は RightToLeft 、基本クラスのプロパティを使用して RightToLeft 基本実装を拡張します。When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. それ以外の場合は、すべての実装を指定する必要があります。Otherwise, you must provide all the implementation. プロパティのアクセサーとアクセサーの両方をオーバーライドする必要はありません get set 。必要な場合は、 RightToLeft 1 つだけをオーバーライドできます。You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.