|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JSplitPane
JSplitPane
は 2 つの Component
を分割するのに使います (2 つだけに分割)。2 つの Component
は Look & Feel の実装を基準にしてグラフィカルに分割されます。そのあとでは、2 つの Component
はユーザが対話的にサイズ変更できるようになります。JSplitPane
の使用に関しては、「The Java Tutorial」の「How to Use Split Panes」を参照してください。
2 つの Component
は、JSplitPane.HORIZONTAL_SPLIT
を使って左右に、JSplitPane.VERTICAL_SPLIT
を使って上下に整列できます。Component
のサイズを変更するには、JSplitPane
の方向に応じて location
が新しい x または y の位置である setDividerLocation
を呼び出すことをお勧めします。
Component
のサイズを目的のサイズに変更するには、resetToPreferredSizes
を呼び出します。
ユーザが Component
のサイズを変更するときには、Components
の最小サイズを使用して、Component
に設定可能な最大または最小の位置が決められます。したがって、2 つのコンポーネントの最小サイズがスプリットぺインのサイズより大きい場合、ディバイダはコンポーネントのサイズ変更を許可しません。JComponent
の最小サイズの変更については、JComponent.setMinimumSize(java.awt.Dimension)
を参照してください。
ユーザが分割区画のサイズを変更する場合は、resizeWeight
プロパティに基づき 2 つのコンポーネントの間に新しいスペースが分配されます。デフォルトの値 0 は右または下のコンポーネントがすべてのスペースを取得することを示し、値 1 は左または上のコンポーネントがすべてのスペースを取得することを示します。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、「JSplitPane
のキーの割り当て」を参照してください。
警告:
このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeansTM の長期間の運用サポートは、java.beans
パッケージに追加されています。詳細は、XMLEncoder
を参照してください。
setDividerLocation(double)
,
resetToPreferredSizes()
入れ子クラスの概要 | |
protected class |
JSplitPane.AccessibleJSplitPane
このクラスは JSplitPane クラス用のユーザ補助機能のサポートを実装しています。 |
クラス javax.swing.JComponent から継承した入れ子クラス |
|
クラス java.awt.Container から継承した入れ子クラス |
|
クラス java.awt.Component から継承した入れ子クラス |
Component.BltBufferStrategy, Component.FlipBufferStrategy |
フィールドの概要 | |
static String |
BOTTOM
Component をもう一方の Component の下に追加するときに使います。 |
static String |
CONTINUOUS_LAYOUT_PROPERTY
continuousLayout のバウンドプロパティ名です。 |
protected boolean |
continuousLayout
サイズ変更の際、ビューが継続して再表示されるかどうかを示します。 |
static String |
DIVIDER
ディバイダを表す Component を追加するときに使います。 |
static String |
DIVIDER_LOCATION_PROPERTY
dividerLocation のバウンドプロパティです。 |
static String |
DIVIDER_SIZE_PROPERTY
ボーダのバウンドプロパティ名です。 |
protected int |
dividerSize
ディバイダのサイズです。 |
static int |
HORIZONTAL_SPLIT
水平分割は、 Component が x 軸に沿って分割されることを示します。 |
static String |
LAST_DIVIDER_LOCATION_PROPERTY
lastLocation のバウンドプロパティです。 |
protected int |
lastDividerLocation
スプリットぺインの以前の位置です。 |
static String |
LEFT
Component をもう一方の Component の左に追加するときに使います。 |
protected Component |
leftComponent
左または上のコンポーネントです。 |
static String |
ONE_TOUCH_EXPANDABLE_PROPERTY
oneTouchExpandable のバウンドプロパティです。 |
protected boolean |
oneTouchExpandable
スプリットぺインをすばやく展開する/収納するために提供される小さなウィジットです。 |
protected int |
orientation
ビューを分割する方法です。 |
static String |
ORIENTATION_PROPERTY
方向 (水平または垂直) のバウンドプロパティ名です。 |
static String |
RESIZE_WEIGHT_PROPERTY
ウェイトのバウンドプロパティです。 |
static String |
RIGHT
Component をもう一方の Component の右に追加するときに使います。 |
protected Component |
rightComponent
右または下のコンポーネントです。 |
static String |
TOP
Component をもう一方の Component の上に追加するときに使います。 |
static int |
VERTICAL_SPLIT
垂直分割は、 Component が y 軸に沿って分割されることを示します。 |
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
JSplitPane()
コンポーネントの 2 つのボタンを使って、連続したレイアウトではなく、水平方向に子コンポーネントが並ぶように設定された新しい JSplitPane を作成します。 |
|
JSplitPane(int newOrientation)
指定された方向に、連続したレイアウトではなく設定された、新しい JSplitPane を作成します。 |
|
JSplitPane(int newOrientation,
boolean newContinuousLayout)
方向と再描画のスタイルを指定して新しい JSplitPane を作成します。 |
|
JSplitPane(int newOrientation,
boolean newContinuousLayout,
Component newLeftComponent,
Component newRightComponent)
方向、再描画スタイル、コンポーネントを指定して新しい JSplitPane を作成します。 |
|
JSplitPane(int newOrientation,
Component newLeftComponent,
Component newRightComponent)
方向と、連続した再描画を行わないコンポーネントを指定して新しい JSplitPane を作成します。 |
メソッドの概要 | |
protected void |
addImpl(Component comp,
Object constraints,
int index)
このスプリットぺインに指定したコンポーネントを追加します。 |
AccessibleContext |
getAccessibleContext()
この JSplitPane に関連した AccessibleContext を返します。 |
Component |
getBottomComponent()
ディバイダの下または右のコンポーネントを返します。 |
int |
getDividerLocation()
setDividerLocation に渡された最終値を返します。 |
int |
getDividerSize()
ディバイダのサイズを返します。 |
int |
getLastDividerLocation()
ディバイダが置かれていた以前の位置を返します。 |
Component |
getLeftComponent()
ディバイダの左 (上) にあるコンポーネントを返します。 |
int |
getMaximumDividerLocation()
Look & Feel の実装からディバイダの最大の位置を返します。 |
int |
getMinimumDividerLocation()
Look & Feel の実装からディバイダの最小の位置を返します。 |
int |
getOrientation()
方向を返します。 |
double |
getResizeWeight()
余分なスペースの配分方法を決める数を返します。 |
Component |
getRightComponent()
ディバイダの右 (または下) のコンポーネントを返します。 |
Component |
getTopComponent()
ディバイダの上または左のコンポーネントを返します。 |
SplitPaneUI |
getUI()
現在の Look & Feel を提供している SplitPaneUI を返します。 |
String |
getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。 |
boolean |
isContinuousLayout()
continuousLayout のプロパティを取得します。 |
boolean |
isOneTouchExpandable()
oneTouchExpandable プロパティを返します。 |
boolean |
isValidateRoot()
true を返すと、 JSplitPane の下位オブジェクトで revalidate を呼び出されて、JSplitPane とそのすべての下位オブジェクトを検証する要求がキューに入れられます。 |
protected void |
paintChildren(Graphics g)
ボーダのペイントとともに、スーパークラスにメッセージが送られたあとで、 finishedPaintingChildren を持つ UI にメッセージを送るためにサブクラス化されます。 |
protected String |
paramString()
この JSplitPane の文字列表現を返します。 |
void |
remove(Component component)
子コンポーネント component を区画から削除します。 |
void |
remove(int index)
指定されたインデックスの Component を削除します。 |
void |
removeAll()
スプリットぺインからすべての子コンポーネントを削除します。 |
void |
resetToPreferredSizes()
子コンポーネントの推奨サイズに基づき JSplitPane レイアウトを配置します。 |
void |
setBottomComponent(Component comp)
コンポーネントをディバイダの下または右に設定します。 |
void |
setContinuousLayout(boolean newContinuousLayout)
continuousLayout プロパティの値を設定します。 |
void |
setDividerLocation(double proportionalLocation)
JSplitPane のサイズのパーセンテージでディバイダの位置を設定します。
|
void |
setDividerLocation(int location)
ディバイダの位置を設定します。 |
void |
setDividerSize(int newSize)
ディバイダのサイズを設定します。 |
void |
setLastDividerLocation(int newLastLocation)
以前にディバイダが置かれていた位置を newLastLocation に設定します。 |
void |
setLeftComponent(Component comp)
コンポーネントをディバイダの左 (上) に設定します。 |
void |
setOneTouchExpandable(boolean newValue)
oneTouchExpandable プロパティの値を設定します。 |
void |
setOrientation(int orientation)
方向、またはスプリッタがどのように分割されるかを設定します。 |
void |
setResizeWeight(double value)
スプリットぺインが変更されたときの余分のスペースの配分方法を指定します。 |
void |
setRightComponent(Component comp)
ディバイダの右 (または下) のコンポーネントを設定します。 |
void |
setTopComponent(Component comp)
コンポーネントをディバイダの上または左に設定します。 |
void |
setUI(SplitPaneUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。 |
void |
updateUI()
L&F が変更されたという UIManager からの通知です。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
フィールドの詳細 |
public static final int VERTICAL_SPLIT
Component
が y 軸に沿って分割されることを示します。たとえば 2 つの Component
が上下に並ぶように分割されることを示します。
public static final int HORIZONTAL_SPLIT
Component
が x 軸に沿って分割されることを示します。たとえば 2 つの Component
が左右に並ぶように分割されることを示します。
public static final String LEFT
Component
をもう一方の Component
の左に追加するときに使います。
public static final String RIGHT
Component
をもう一方の Component
の右に追加するときに使います。
public static final String TOP
Component
をもう一方の Component
の上に追加するときに使います。
public static final String BOTTOM
Component
をもう一方の Component
の下に追加するときに使います。
public static final String DIVIDER
Component
を追加するときに使います。
public static final String ORIENTATION_PROPERTY
public static final String CONTINUOUS_LAYOUT_PROPERTY
public static final String DIVIDER_SIZE_PROPERTY
public static final String ONE_TOUCH_EXPANDABLE_PROPERTY
public static final String LAST_DIVIDER_LOCATION_PROPERTY
public static final String DIVIDER_LOCATION_PROPERTY
public static final String RESIZE_WEIGHT_PROPERTY
protected int orientation
protected boolean continuousLayout
protected Component leftComponent
protected Component rightComponent
protected int dividerSize
protected boolean oneTouchExpandable
protected int lastDividerLocation
コンストラクタの詳細 |
public JSplitPane()
JSplitPane
を作成します。
public JSplitPane(int newOrientation)
JSplitPane
を作成します。
newOrientation
- JSplitPane.HORIZONTAL_SPLIT
または JSplitPane.VERTICAL_SPLIT
IllegalArgumentException
- orientation
が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらかでない場合public JSplitPane(int newOrientation, boolean newContinuousLayout)
JSplitPane
を作成します。
newOrientation
- JSplitPane.HORIZONTAL_SPLIT
または JSplitPane.VERTICAL_SPLIT
newContinuousLayout
- boolean 値。ディバイダの位置が変更されるときに、コンポーネントが連続して再描画されるようにする場合は true。ディバイダの位置の変更が中止されるまで再描画に待機する場合は false
IllegalArgumentException
- orientation
が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらかでない場合public JSplitPane(int newOrientation, Component newLeftComponent, Component newRightComponent)
JSplitPane
を作成します。
newOrientation
- JSplitPane.HORIZONTAL_SPLIT
または JSplitPane.VERTICAL_SPLIT
newLeftComponent
- 水平方向に分割された区画の左、または垂直方向に分割された区画の上に表示される Component
newRightComponent
- 水平方向に分割された区画の右、または垂直方向に分割された区画の下に表示される Component
IllegalArgumentException
- orientation
が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらかでない場合public JSplitPane(int newOrientation, boolean newContinuousLayout, Component newLeftComponent, Component newRightComponent)
JSplitPane
を作成します。
newOrientation
- JSplitPane.HORIZONTAL_SPLIT
または JSplitPane.VERTICAL_SPLIT
newContinuousLayout
- boolean 値。ディバイダの位置が変更されるときに、コンポーネントが連続して再描画されるようにする場合は true。ディバイダの位置の変更が中止されるまで再描画に待機する場合は falsenewLeftComponent
- 水平方向に分割された区画の左、または垂直方向に分割された区画の上に表示される Component
newRightComponent
- 水平方向に分割された区画の右、または垂直方向に分割された区画の下に表示される Component
IllegalArgumentException
- orientation
が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらかでない場合メソッドの詳細 |
public void setUI(SplitPaneUI ui)
ui
- SplitPaneUI
L&F オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public SplitPaneUI getUI()
SplitPaneUI
を返します。
SplitPaneUI
オブジェクトpublic void updateUI()
UIManager
からの通知です。現在の UI オブジェクトを UIManager
からの最新バージョンに置き換えます。
JComponent
内の updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
内の getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setDividerSize(int newSize)
newSize
- ディバイダのサイズをピクセル数で指定する int 値public int getDividerSize()
public void setLeftComponent(Component comp)
comp
- その位置に表示する Component
public Component getLeftComponent()
Component
public void setTopComponent(Component comp)
comp
- その位置に表示する Component
public Component getTopComponent()
Component
public void setRightComponent(Component comp)
comp
- その位置に表示する Component
public Component getRightComponent()
Component
public void setBottomComponent(Component comp)
comp
- その位置に表示する Component
public Component getBottomComponent()
Component
public void setOneTouchExpandable(boolean newValue)
oneTouchExpandable
プロパティの値を設定します。この値は、JSplitPane
がディバイダの UI ウィジェットを提供し、ディバイダを迅速に展開/収納するために、true
に設定する必要があります。このプロパティのデフォルト値は false
です。一部の Look & Feel がワンタッチの展開をサポートしない場合があります。その場合、このプロパティは無視されます。
newValue
- スプリットぺインが展開/収納ウィジェットを提供するよう指定する true
isOneTouchExpandable()
public boolean isOneTouchExpandable()
oneTouchExpandable
プロパティを返します。
oneTouchExpandable
プロパティの値setOneTouchExpandable(boolean)
public void setLastDividerLocation(int newLastLocation)
newLastLocation
に設定します。
newLastLocation
- 区画の左 (または上) 端からディバイダの左 (または上) 端までの、ディバイダの以前の位置をピクセル数で指定する int 値public int getLastDividerLocation()
public void setOrientation(int orientation)
orientation
- 方向を指定する整数値
IllegalArgumentException
- 方向が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらかでない場合public int getOrientation()
setOrientation(int)
public void setContinuousLayout(boolean newContinuousLayout)
continuousLayout
プロパティの値を設定します。この値はユーザが操作したときに子コンポーネントが連続的に再描画されて配置されるように true
に設定する必要があります。このプロパティのデフォルトの値は false
です。一部の Look & Feel は連続したレイアウトをサポートしていません。その場合、このプロパティは無視されます。
newContinuousLayout
- ディバイダの位置が変更されたときにコンポーネントが連続的に再描画される場合は true
isContinuousLayout()
public boolean isContinuousLayout()
continuousLayout
のプロパティを取得します。
continuousLayout
のプロパティの値setContinuousLayout(boolean)
public void setResizeWeight(double value)
value
- 上記のとおり
IllegalArgumentException
- value
が 0 または 1 の場合public double getResizeWeight()
public void resetToPreferredSizes()
JSplitPane
レイアウトを配置します。通常は、これによってディバイダの位置が変わります。
public void setDividerLocation(double proportionalLocation)
JSplitPane
のサイズのパーセンテージでディバイダの位置を設定します。
このメソッドは setDividerLocation(int)
に基づいて実装されます。このメソッドは現在のサイズに基づきスプリットぺインのサイズを直ちに変更します。スプリットぺインがスクリーン上で正しく実現されない場合、新しいディバイダの位置は現在のサイズ * proportionalLocation が 0 になり、このメソッドの効果はありません。
proportionalLocation
- 0 (上または左) から 1.0 (下または右) までのパーセンテージを指定する倍精度浮動小数点値
IllegalArgumentException
- 指定された位置が 0 または 1.0 である場合public void setDividerLocation(int location)
setLastDividerLocation
により変更されます。
location
- UI 固有の値 (通常はピクセル数) を指定する int 値public int getDividerLocation()
setDividerLocation
に渡された最終値を返します。このメソッドで返された値は、setDividerLocation
に渡された値が現在のサイズより大きい場合は、実際のディバイダの位置と異なる場合があります。
public int getMinimumDividerLocation()
null
の場合は -1public int getMaximumDividerLocation()
null
の場合は -1public void remove(Component component)
component
を区画から削除します。必要に応じて、leftComponent
または rightComponent
インスタンス変数をリセットします。
Container
内の remove
component
- 削除する Component
Container.add(java.awt.Component)
public void remove(int index)
Component
を削除します。必要に応じて、leftComponent
および rightComponent
インスタンス変数を変更してから、スーパークラスにメッセージを送ります。
Container
内の remove
index
- 削除するコンポーネントを指定する int 値。1 では左または上のコンポーネントが指定され、2 では下または右のコンポーネントが指定されるContainer.add(java.awt.Component)
public void removeAll()
leftComonent
および rightComponent
インスタンス変数をリセットします。
Container
内の removeAll
Container.add(java.awt.Component)
,
Container.remove(int)
public boolean isValidateRoot()
JSplitPane
の下位オブジェクトで revalidate
を呼び出されて、JSplitPane
とそのすべての下位オブジェクトを検証する要求がキューに入れられます。
JComponent
内の isValidateRoot
JComponent.revalidate()
protected void addImpl(Component comp, Object constraints, int index)
constraints
が左または上あるいは右または下の子コンポーネントを識別し、その識別子を持つコンポーネントが以前に追加されている場合は、それを削除してから、その位置に comp
を追加します。constraints
が既知の識別子でない場合、レイアウトマネージャは IllegalArgumentException
をスローします。
指定できる制約オブジェクト (String) は次のとおりです。
constraints
オブジェクトが null
の場合、利用可能な最初の位置にコンポーネントが追加されます (開いている場合は左または上、そうでない場合は右または下)。
Container
内の addImpl
comp
- 追加するコンポーネントconstraints
- コンポーネントのレイアウト制約 (位置) を指定する Object
index
- コンテナリスト内のインデックスを指定する int 値
IllegalArgumentException
- constraints
オブジェクトが既存のコンポーネントに一致しない場合Container.addImpl(Component, Object, int)
protected void paintChildren(Graphics g)
finishedPaintingChildren
を持つ UI にメッセージを送るためにサブクラス化されます。
JComponent
内の paintChildren
g
- ペイントする Graphics
コンテキストJComponent.paint(java.awt.Graphics)
,
Container.paint(java.awt.Graphics)
protected String paramString()
JSplitPane
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。
JComponent
内の paramString
JSplitPane
の文字列表現public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
JComponent
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.