Control.RightToLeft プロパティ
コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。
Public Overridable Property RightToLeft As RightToLeft
[C#]
public virtual RightToLeft RightToLeft {get; set;}
[C++]
public: __property virtual RightToLeft get_RightToLeft();public: __property virtual void set_RightToLeft(RightToLeft);
[JScript]
public function get RightToLeft() : RightToLeft;public function set RightToLeft(RightToLeft);
プロパティ値
RightToLeft 値の 1 つ。既定値は Inherit です。
例外
例外の種類 | 条件 |
---|---|
InvalidEnumArgumentException | 代入された値が、 RightToLeft 値ではありません。 |
解説
RightToLeft プロパティがアンビエント プロパティです。アンビエント プロパティは、コントロール プロパティです。設定しない場合は、親コントロールから取得されます。たとえば、 Button は、既定では親の Form と同じ BackColor を持ちます。アンビエント プロパティの詳細については、 AmbientProperties クラスまたは Control クラスの概要を参照してください。
RightToLeft プロパティは、ヘブライ語やアラビア語などの右から左へ表記される言語をサポートする、国際対応のアプリケーションで使用します。このプロパティを RightToLeft.Yes に設定すると、テキストを含むコントロール要素は右から左に表示されます。
コントロールがトップレベル コントロールである場合は、ユーザーのオペレーティング システムが照会されて、コントロールが右から左への表示をサポートする必要があるかどうかが確認されます。
RightToLeft.Yes の RightToLeft プロパティ値によって、コントロールの要素が受ける影響の例を次に示します。
- 垂直スクロール バーは、スクロールできるコントロール (たとえば、 Form 、 Panel 、複数行の TextBox 、および RichTextBox) の右側ではなく左側に表示されます。
- 水平スクロール バーの先頭は、右寄せのスクロール ボックス (つまみ) になります。
- CheckAlign プロパティによって制御される、チェック ボックスの要素の配置は、 CheckBox コントロールと RadioButton コントロールでは反転します。
- Form のタイトル バーのテキストは、右寄せで表示されます。アイコンおよびコントロール ボックスは、それぞれ左寄せおよび右寄せの配置のまま変わりません。
- リスト ボックス、コンボ ボックス、アップダウンの各コントロール内の項目は右寄せになります。
- 上向き矢印ボタンおよび下向き矢印ボタンは、 NumericUpDown コントロールおよび DomainUpDown コントロールでは左寄せで表示されます。
- メニュー (MainMenu 、 MenuItem 、および ContextMenu) は右寄せで表示されます。
- ToolBar コントロール上のツール バー ボタンの配置、または ToolBarButton 上のテキストの配置は、 RightToLeft プロパティによっては影響されません。
- AxHost は右から左への配置をサポートしますが、ActiveX コントロールに対する影響は、コントロールの作成者が実装した右から左への表示のサポートがどの程度までかによって変わります。
メモ RightToLeft プロパティ値が RightToLeft.Yes に設定されている場合、コントロールの要素の水平方向の配置は逆になりますが、要素の配置整列値は変わりません。たとえば、 TextAlign プロパティ値が HorizontalAlignment.Left の TextBox コントロールでは、テキストは右寄せで表示されますが、プロパティ値は HorizontalAlignment.Left のまま変わりません。ただし、 RightToLeft プロパティ値が RightToLeft.Yes に設定されていても、 TextAlign プロパティが HorizontalAlignment.Right に設定されている場合は、テキストが左寄せで表示されます。
継承時の注意: 派生クラスで RightToLeft プロパティをオーバーライドする場合は、基本クラスの RightToLeft プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。 RightToLeft プロパティの get アクセサと set アクセサの両方をオーバーライドする必要はありません。必要に応じて 1 つだけオーバーライドする場合はあります。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
Control クラス | Control メンバ | System.Windows.Forms 名前空間 | RightToLeft | HorizontalAlignment | RtlTranslateAlignment | RtlTranslateContent | RtlTranslateHorizontal | RtlTranslateLeftRight