Control.RightToLeft プロパティ

定義

コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。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 は、既定では親 Form と同じ BackColor を持ちます。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.YesRightToLeft プロパティ値によってコントロール要素がどのように影響を受けるかを示します。The following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • 垂直スクロールバーは、スクロール可能なコントロールの右側ではなく左側に表示されます (たとえば、FormPanel、複数行 TextBoxRichTextBox)。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.

  • メニュー (MainMenuMenuItemContextMenu) が右上に表示されます。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. RightToLeft プロパティの getset の両方のアクセサーをオーバーライドする必要はありません。必要に応じて、オーバーライドできるのは1つだけです。You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

適用対象

こちらもご覧ください