JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
クラス JSplitPane

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.JSplitPane
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible

public class JSplitPane
extends JComponent
implements Accessible

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 を実行するアプリケーション間の RMI に適しています。JDK バージョン 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.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 からの通知です。
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承されたメソッド
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
クラス java.awt.Component から継承されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

VERTICAL_SPLIT

public static final int VERTICAL_SPLIT
垂直分割は、Component が y 軸に沿って分割されることを示します。たとえば 2 つの Component が上下に並ぶように分割されることを示します。

関連項目:
定数フィールド値

HORIZONTAL_SPLIT

public static final int HORIZONTAL_SPLIT
水平分割は、Component が x 軸に沿って分割されることを示します。たとえば 2 つの Component が左右に並ぶように分割されることを示します。

関連項目:
定数フィールド値

LEFT

public static final String LEFT
Component をもう一方の Component の左に追加するときに使います。

関連項目:
定数フィールド値

RIGHT

public static final String RIGHT
Component をもう一方の Component の右に追加するときに使います。

関連項目:
定数フィールド値

TOP

public static final String TOP
Component をもう一方の Component の上に追加するときに使います。

関連項目:
定数フィールド値

BOTTOM

public static final String BOTTOM
Component をもう一方の Component の下に追加するときに使います。

関連項目:
定数フィールド値

DIVIDER

public static final String DIVIDER
ディバイダを表す Component を追加するときに使います。

関連項目:
定数フィールド値

ORIENTATION_PROPERTY

public static final String ORIENTATION_PROPERTY
方向 (水平または垂直) のバウンドプロパティ名です。

関連項目:
定数フィールド値

CONTINUOUS_LAYOUT_PROPERTY

public static final String CONTINUOUS_LAYOUT_PROPERTY
continuousLayout のバウンドプロパティ名です。

関連項目:
定数フィールド値

DIVIDER_SIZE_PROPERTY

public static final String DIVIDER_SIZE_PROPERTY
ボーダのバウンドプロパティ名です。

関連項目:
定数フィールド値

ONE_TOUCH_EXPANDABLE_PROPERTY

public static final String ONE_TOUCH_EXPANDABLE_PROPERTY
oneTouchExpandable のバウンドプロパティです。

関連項目:
定数フィールド値

LAST_DIVIDER_LOCATION_PROPERTY

public static final String LAST_DIVIDER_LOCATION_PROPERTY
lastLocation のバウンドプロパティです。

関連項目:
定数フィールド値

DIVIDER_LOCATION_PROPERTY

public static final String DIVIDER_LOCATION_PROPERTY
dividerLocation のバウンドプロパティです。

導入されたバージョン:
1.3
関連項目:
定数フィールド値

RESIZE_WEIGHT_PROPERTY

public static final String RESIZE_WEIGHT_PROPERTY
ウェイトのバウンドプロパティです。

導入されたバージョン:
1.3.
関連項目:
定数フィールド値

orientation

protected int orientation
ビューを分割する方法です。


continuousLayout

protected boolean continuousLayout
サイズ変更の際、ビューが継続して再表示されるかどうかを示します。


leftComponent

protected Component leftComponent
左または上のコンポーネントです。


rightComponent

protected Component rightComponent
右または下のコンポーネントです。


dividerSize

protected int dividerSize
ディバイダのサイズです。


oneTouchExpandable

protected boolean oneTouchExpandable
分割区画をすばやく展開/収納するために提供される小さなウィジットです。


lastDividerLocation

protected int lastDividerLocation
分割区画の以前の位置です。

コンストラクタの詳細

JSplitPane

public JSplitPane()
コンポーネントの 2 つのボタンを使って、連続したレイアウトではなく、水平方向に子コンポーネントが並ぶように設定された新しい JSplitPane を作成します。


JSplitPane

public JSplitPane(int newOrientation)
指定された方向に、連続したレイアウトではなく設定された、新しい JSplitPane を作成します。

パラメータ:
newOrientation - JSplitPane.HORIZONTAL_SPLIT または JSplitPane.VERTICAL_SPLIT
例外:
IllegalArgumentException - orientation が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらでもない場合

JSplitPane

public JSplitPane(int newOrientation,
                  boolean newContinuousLayout)
方向と再描画のスタイルを指定して新しい JSplitPane を作成します。

パラメータ:
newOrientation - JSplitPane.HORIZONTAL_SPLIT または JSplitPane.VERTICAL_SPLIT
newContinuousLayout - boolean 値。ディバイダの位置が変更されるときに、コンポーネントが連続して再描画されるようにする場合は true。ディバイダの位置の変更が中止されるまで再描画に待機する場合は false
例外:
IllegalArgumentException - orientation が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらでもない場合

JSplitPane

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 のどちらでもない場合

JSplitPane

public JSplitPane(int newOrientation,
                  boolean newContinuousLayout,
                  Component newLeftComponent,
                  Component newRightComponent)
方向、再描画スタイル、コンポーネントを指定して新しい JSplitPane を作成します。

パラメータ:
newOrientation - JSplitPane.HORIZONTAL_SPLIT または JSplitPane.VERTICAL_SPLIT
newContinuousLayout - boolean 値。ディバイダの位置が変更されるときに、コンポーネントが連続して再描画されるようにする場合は true。ディバイダの位置の変更が中止されるまで再描画に待機する場合は false
newLeftComponent - 水平方向に分割された区画の左、または垂直方向に分割された区画の上に表示される Component
newRightComponent - 水平方向に分割された区画の右、または垂直方向に分割された区画の下に表示される Component
例外:
IllegalArgumentException - orientation が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらでもない場合
メソッドの詳細

setUI

public void setUI(SplitPaneUI ui)
このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:
ui - SplitPaneUI L&F オブジェクト
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

getUI

public SplitPaneUI getUI()
現在の Look & Feel を提供している SplitPaneUI を返します。

戻り値:
このコンポーネントを描画する SplitPaneUI オブジェクト

updateUI

public void updateUI()
L&F が変更されたという UIManager からの通知です。現在の UI オブジェクトを UIManager からの最新バージョンに置き換えます。

オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
文字列「SplitPaneUI」
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setDividerSize

public void setDividerSize(int newSize)
ディバイダのサイズを設定します。

パラメータ:
newSize - ディバイダのサイズをピクセル数で指定する int 値

getDividerSize

public int getDividerSize()
ディバイダのサイズを返します。

戻り値:
ディバイダのサイズをピクセル数で指定する int 値

setLeftComponent

public void setLeftComponent(Component comp)
コンポーネントをディバイダの左 (上) に設定します。

パラメータ:
comp - その位置に表示する Component

getLeftComponent

public Component getLeftComponent()
ディバイダの左 (上) にあるコンポーネントを返します。

戻り値:
その位置に表示されている Component

setTopComponent

public void setTopComponent(Component comp)
コンポーネントをディバイダの上または左に設定します。

パラメータ:
comp - その位置に表示する Component

getTopComponent

public Component getTopComponent()
ディバイダの上または左のコンポーネントを返します。

戻り値:
その位置に表示されている Component

setRightComponent

public void setRightComponent(Component comp)
ディバイダの右 (または下) のコンポーネントを設定します。

パラメータ:
comp - その位置に表示する Component

getRightComponent

public Component getRightComponent()
ディバイダの右 (または下) のコンポーネントを返します。

戻り値:
その位置に表示されている Component

setBottomComponent

public void setBottomComponent(Component comp)
コンポーネントをディバイダの下または右に設定します。

パラメータ:
comp - その位置に表示する Component

getBottomComponent

public Component getBottomComponent()
ディバイダの下または右のコンポーネントを返します。

戻り値:
その位置に表示されている Component

setOneTouchExpandable

public void setOneTouchExpandable(boolean newValue)
oneTouchExpandable プロパティの値を設定します。この値は、JSplitPane がディバイダの UI ウィジェットを提供し、ディバイダを迅速に展開/収納するために、true に設定する必要があります。このプロパティのデフォルト値は false です。一部の Look & Feel がワンタッチの展開をサポートしない場合があります。その場合、このプロパティは無視されます。

パラメータ:
newValue - 分割区画が展開/収納ウィジェットを提供するよう指定する true
関連項目:
isOneTouchExpandable()

isOneTouchExpandable

public boolean isOneTouchExpandable()
oneTouchExpandable プロパティを返します。

戻り値:
oneTouchExpandable プロパティの値
関連項目:
setOneTouchExpandable(boolean)

setLastDividerLocation

public void setLastDividerLocation(int newLastLocation)
以前にディバイダが置かれていた位置を newLastLocation に設定します。

パラメータ:
newLastLocation - 区画の左 (または上) 端からディバイダの左 (または上) 端までの、ディバイダの以前の位置をピクセル数で指定する int 値

getLastDividerLocation

public int getLastDividerLocation()
以前にディバイダが置かれていた位置を返します。

戻り値:
区画の左 (または上) 端からディバイダの左 (または上) 端までの、ディバイダの以前の位置をピクセル数で指定する int 値

setOrientation

public void setOrientation(int orientation)
方向、またはスプリッタがどのように分割されるかを設定します。次のオプションがあります。

パラメータ:
orientation - 方向を指定する整数値
例外:
IllegalArgumentException - 方向が HORIZONTAL_SPLIT または VERTICAL_SPLIT のどちらでもない場合

getOrientation

public int getOrientation()
方向を返します。

戻り値:
方向を指定する整数値
関連項目:
setOrientation(int)

setContinuousLayout

public void setContinuousLayout(boolean newContinuousLayout)
continuousLayout プロパティの値を設定します。この値はユーザが操作したときに子コンポーネントが連続的に再描画されて配置されるように true に設定する必要があります。このプロパティのデフォルトの値は false です。一部の Look & Feel は連続したレイアウトをサポートしていません。その場合、このプロパティは無視されます。

パラメータ:
newContinuousLayout - ディバイダの位置が変更されたときにコンポーネントが連続的に再描画される場合は true
関連項目:
isContinuousLayout()

isContinuousLayout

public boolean isContinuousLayout()
continuousLayout のプロパティを取得します。

戻り値:
continuousLayout のプロパティの値
関連項目:
setContinuousLayout(boolean)

setResizeWeight

public void setResizeWeight(double value)
分割区画が変更されたときの余分のスペースの配分方法を指定します。デフォルトの値 0 は、左または上のコンポーネントが固定され右または下のコンポーネントがすべての余分なスペースを取得することを示し、値 1 は右または下のコンポーネントが固定され左または上のコンポーネントがすべての余分なスペースを取得することを示します。特に、左または上のコンポーネントは余分なスペース (ウエイト * 差) を取得し、右または下のコンポーネントは余分のスペースの差 (1 - ウエイト) * を取得します。

パラメータ:
value - 上記のとおり
例外:
IllegalArgumentException - value が 0 より小さいか、1 より大きい場合
導入されたバージョン:
1.3

getResizeWeight

public double getResizeWeight()
余分なスペースの配分方法を決める数を返します。

戻り値:
分割区画のサイズ変更時の余分なスペースの配分方法
導入されたバージョン:
1.3

resetToPreferredSizes

public void resetToPreferredSizes()
子コンポーネントの適切なサイズに基づき JSplitPane レイアウトを配置します。通常は、これによってディバイダの位置が変わります。


setDividerLocation

public void setDividerLocation(double proportionalLocation)
JSplitPane のサイズのパーセンテージでディバイダの位置を設定します。

このメソッドは setDividerLocation(int) に基づいて実装されます。このメソッドは現在のサイズに基づき分割区画のサイズを直ちに変更します。分割区画がスクリーン上で正しく実現されない場合、新しいディバイダの位置は現在のサイズ * proportionalLocation が 0 になり、このメソッドの効果はありません。

パラメータ:
proportionalLocation - 0 (上または左) から 1.0 (下または右) までのパーセンテージを指定する倍精度浮動小数点値
例外:
IllegalArgumentException - 指定された位置が 0 より小さいか、1.0 より大きい場合

setDividerLocation

public void setDividerLocation(int location)
ディバイダの位置を設定します。これは、Look & Feel の実装に渡されてからリスナーに通知されます。0 より小さい値は、ディバイダが左または上のコンポーネントの適切なサイズの値にリセットされる必要があることを意味しています。リスナーに通知してから、最終的なディバイダの位置が setLastDividerLocation により変更されます。

パラメータ:
location - UI 固有の値 (通常はピクセル数) を指定する int 値

getDividerLocation

public int getDividerLocation()
setDividerLocation に渡された最終値を返します。このメソッドで返された値は、setDividerLocation に渡された値が現在のサイズより大きい場合は、実際のディバイダの位置と異なる場合があります。

戻り値:
ディバイダの位置を指定する int 値

getMinimumDividerLocation

public int getMinimumDividerLocation()
Look & Feel の実装からディバイダの最小の位置を返します。

戻り値:
最小の位置の UI 固有の値 (通常はピクセル数) を指定する int 値。UI が null の場合は -1

getMaximumDividerLocation

public int getMaximumDividerLocation()
Look & Feel の実装からディバイダの最大の位置を返します。

戻り値:
最大の位置の UI 固有の値 (通常はピクセル数) を指定する int 値。UI が null の場合は -1

remove

public void remove(Component component)
子コンポーネント component を区画から削除します。必要に応じて、leftComponent または rightComponent インスタンス変数をリセットします。

オーバーライド:
クラス Container 内の remove
パラメータ:
component - 削除する Component
関連項目:
Container.add(java.awt.Component), Container.remove(int)

remove

public void remove(int index)
指定されたインデックスの Component を削除します。必要に応じて、leftComponent および rightComponent インスタンス変数を変更してから、スーパークラスにメッセージを送ります。

オーバーライド:
クラス Container 内の remove
パラメータ:
index - 削除するコンポーネントを指定する int 値。1 では左または上のコンポーネントが指定され、2 では下または右のコンポーネントが指定される
関連項目:
Container.add(java.awt.Component)

removeAll

public void removeAll()
分割区画からすべての子コンポーネントを削除します。leftComonent および rightComponent インスタンス変数をリセットします。

オーバーライド:
クラス Container 内の removeAll
関連項目:
Container.add(java.awt.Component), Container.remove(int)

isValidateRoot

public boolean isValidateRoot()
true を返すと、JSplitPane の下位オブジェクトで revalidate を呼び出されて、JSplitPane とそのすべての下位オブジェクトを検証する要求がキューに入れられます。

オーバーライド:
クラス JComponent 内の isValidateRoot
戻り値:
true
関連項目:
JComponent.revalidate()

addImpl

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)

paintChildren

protected void paintChildren(Graphics g)
ボーダのペイントとともに、スーパークラスにメッセージが送られたあとで、finishedPaintingChildren を持つ UI にメッセージを送るためにサブクラス化されます。

オーバーライド:
クラス JComponent 内の paintChildren
パラメータ:
g - ペイントする Graphics コンテキスト
関連項目:
JComponent.paint(java.awt.Graphics), Container.paint(java.awt.Graphics)

paramString

protected String paramString()
この JSplitPane の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:
クラス JComponent 内の paramString
戻り値:
JSplitPane の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JSplitPane に関連した AccessibleContext を返します。分割区画の場合、AccessibleContext は AccessibleJSplitPane の形式を取ります。必要に応じて新規の AccessibleJSplitPane インスタンスが作成されます。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JSplitPane の AccessibleContext として機能する AccessibleJSplitPane

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。