Control.RightToLeft プロパティ

.NET Framework クラス ライブラリ リファレンス

Control.RightToLeft プロパティ

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 RightToLeft As RightToLeft

Visual Basic (使用法)

Dim instance As Control
Dim value As RightToLeft

value = instance.RightToLeft

instance.RightToLeft = value

C#

[LocalizableAttribute(true)] 
public virtual RightToLeft RightToLeft { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property RightToLeft RightToLeft {
    RightToLeft get ();
    void set (RightToLeft value);
}

J#

/** @property */
public RightToLeft get_RightToLeft ()

/** @property */
public void set_RightToLeft (RightToLeft value)

JScript

public function get RightToLeft
 () : RightToLeft

public function set RightToLeft
 (value : RightToLeft)

プロパティ値
RightToLeft 値の 1 つ。既定値は Inherit です。

例外

例外の種類	条件
InvalidEnumArgumentException	代入された値が、RightToLeft 値ではありません。

解説

RightToLeft プロパティがアンビエント プロパティです。アンビエント プロパティは、コントロール プロパティです。設定しない場合は、親コントロールから取得されます。たとえば、Button は、既定では親の Form と同じ BackColor を持ちます。アンビエント プロパティの詳細については、AmbientProperties クラスまたは Control クラスの概要を参照してください。

RightToLeft プロパティは、ヘブライ語やアラビア語などの右から左へ表記される言語をサポートする、国際対応のアプリケーションで使用します。このプロパティを RightToLeft.Yes に設定すると、テキストを含むコントロール要素は右から左に表示されます。

メモ
RightToLeft プロパティの値が実行時に変更された場合、書式指定のない生のテキストだけが保持されます。

RightToLeft.Yes の RightToLeft プロパティ値によって、コントロールの要素が受ける影響の例を次に示します。

• 垂直スクロール バーは、スクロールできるコントロール (たとえば、Form、Panel、複数行の TextBox、および RichTextBox) の右側ではなく左側に表示されます。

• 水平スクロール バーの先頭は、右寄せのスクロール ボックス (つまみ) になります。

• CheckAlign プロパティによって制御される、チェック ボックスの要素の配置は、CheckBox コントロールと RadioButton コントロールでは反転します。

• リスト ボックス、コンボ ボックス、アップダウンの各コントロール内の項目は右寄せになります。

• 上向き矢印ボタンおよび下向き矢印ボタンは、NumericUpDown コントロールおよび DomainUpDown コントロールでは左寄せで表示されます。

• メニュー (MainMenu、MenuItem、および ContextMenu) は右寄せで表示されます。

• ToolBar コントロール上のツール バー ボタンの配置、または ToolBarButton 上のテキストの配置は、RightToLeft プロパティによっては影響されません。

• AxHost は右から左への配置をサポートしますが、ActiveX コントロールに対する影響は、コントロールの作成者が実装した右から左への表示のサポートがどの程度までかによって変わります。

継承時の注意 派生クラスで RightToLeft プロパティをオーバーライドする場合は、基本クラスの RightToLeft プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。RightToLeft プロパティの get アクセサと set アクセサの両方をオーバーライドする必要はありません。必要に応じて 1 つのアクセサだけをオーバーライドできます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
RightToLeft
HorizontalAlignment
RtlTranslateAlignment
RtlTranslateContent
RtlTranslateHorizontal
RtlTranslateLeftRight