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

定義

コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。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

プロパティ値

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 、既定では、はそのBackColorFormと同じになります。For example, a Button will have the same BackColor as its parent Form by default. アンビエントプロパティの詳細についてAmbientProperties Controlは、クラスまたはクラスの概要に関するトピックを参照してください。For 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たとえば、 TextBox、、 RichTextBoxmultiline、および)。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の配置は、 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右から左への配置をサポートします。ただし、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. プロパティのset get アクセサーとアクセサーの両方をオーバーライドする必要はありません。必要な場合は、1つだけをオーバーライドできます。RightToLeftYou are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

適用対象

こちらもご覧ください