|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JSplitPane
public class 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
のサイズを変更するときは、Component
の最小サイズを使用して、Component
に設定できる最大または最小の位置を決めます。したがって、2 つのコンポーネントの最小サイズが分割区画のサイズより大きい場合、ディバイダはコンポーネントのサイズ変更を許可しません。JComponent
の最小サイズの変更方法については、JComponent.setMinimumSize(java.awt.Dimension)
を参照してください。
ユーザーが分割区画のサイズを変更すると、resizeWeight
プロパティーに基づき 2 つのコンポーネントの間に新しいスペースが分配されます。デフォルトの値 0 は右または下のコンポーネントがすべてのスペースを取得することを示し、値 1 は左または上のコンポーネントがすべてのスペースを取得することを示します。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans™ の長期間の運用サポートは、java.beans
パッケージに追加されています。詳細は、XMLEncoder
を参照してください。
setDividerLocation(double)
,
resetToPreferredSizes()
入れ子のクラスの概要 | |
---|---|
protected class |
JSplitPane.AccessibleJSplitPane
このクラスは JSplitPane クラス用のアクセシビリティーサポートを実装しています。 |
クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース |
---|
JComponent.AccessibleJComponent |
クラス java.awt.Container から継承された入れ子のクラス/インタフェース |
---|
Container.AccessibleAWTContainer |
クラス java.awt.Component から継承された入れ子のクラス/インタフェース |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, 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
- ディバイダの以前の位置を、 区画の左 (または上) 端からディバイダの左 (または上) 端までの ピクセル数で指定する整数値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)
,
Container.validate()
,
Container.remove(int)
public void remove(int index)
Component
を削除します。必要に応じて、leftComponent
および rightComponent
インスタンス変数を変更してから、スーパークラスにメッセージを送ります。
Container
内の remove
index
- 削除するコンポーネントを指定する int 値。1 では左または上のコンポーネントが指定され、2 では下または右のコンポーネントが指定されるContainer.add(java.awt.Component)
,
Container.validate()
,
Container.getComponentCount()
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 Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。