|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.JScrollPane
ビューポート、オプションの垂直および水平スクロールバー、およびオプションの行および列見出しビューポートを管理する特殊なコンテナです。
|
スクロールバーとビューポートのほかに、JScrollPane には列ヘッダと行ヘッダがある場合もあります。これらはそれぞれ setRowHeaderView
と setColumnHeaderView
を使って指定する JViewport オブジェクトです。列ヘッダビューポートは自動的に左右にスクロールして、メインビューポートの左右へのスクロールを追跡します。垂直にはスクロールしません。行ヘッダも同じように動作します。
デフォルトでは、コーナーは空です。スクロール区画に追加したい機能や装飾がある場合には、setCorner
を使ってコンポーネントをコーナーに追加することができます。コーナーコンポーネントのサイズは、ヘッダとその周りのスクロールバーのサイズによって決まります。
メインビューポートの周りにボーダを追加するには、setViewportBorder
を使用できます。もちろん、setBorder
を使ってスクロール区画全体にボーダを追加することもできます。
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JScrollPane のキーの割り当てを参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
JScrollBar
,
JViewport
,
setViewportView(java.awt.Component)
,
setRowHeaderView(java.awt.Component)
,
setColumnHeaderView(java.awt.Component)
,
setCorner(java.lang.String, java.awt.Component)
,
setViewportBorder(javax.swing.border.Border)
, 直列化された形式内部クラスの概要 | |
protected class |
JScrollPane.AccessibleJScrollPane
オブジェクトのユーザ補助機能を取得するために使用するクラスです。 |
protected class |
JScrollPane.ScrollBar
デフォルトでは、JScrollPane はこのクラスのインスタンスであるスクロールバーを作成します。 |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
フィールドの概要 | |
protected JViewport |
columnHeader
列ヘッダの子です。 |
protected JScrollBar |
horizontalScrollBar
スクロール区画の水平スクロールバーの子です。 |
protected int |
horizontalScrollBarPolicy
水平スクロールバーの表示ポリシーです。 |
protected Component |
lowerLeft
左下隅に表示するコンポーネントです。 |
protected Component |
lowerRight
右下隅に表示するコンポーネントです。 |
protected JViewport |
rowHeader
行ヘッダの子です。 |
protected Component |
upperLeft
左上隅に表示するコンポーネントです。 |
protected Component |
upperRight
右上隅に表示するコンポーネントです。 |
protected JScrollBar |
verticalScrollBar
スクロール区画の垂直スクロールバーの子です。 |
protected int |
verticalScrollBarPolicy
垂直スクロールバーの表示ポリシーです。 |
protected JViewport |
viewport
スクロール区画のビューポートの子です。 |
クラス 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 |
コンストラクタの概要 | |
JScrollPane()
必要に応じて水平および垂直の両方のスクロールバーが表示される空の (ビューポイントのビューがない) JScrollPane を作成します。 |
|
JScrollPane(Component view)
指定されたコンポーネントのコンテンツを表示する JScrollPane を作成します。 |
|
JScrollPane(Component view,
int vsbPolicy,
int hsbPolicy)
ビューの位置を 1 組のスクロールバーを使って制御できるビューポート内のビューコンポーネントを表示する、ScrollPane を作成します。 |
|
JScrollPane(int vsbPolicy,
int hsbPolicy)
スクロールバーポリシーを指定して空の (ビューポイントのビューがない) JScrollPane を作成します。 |
メソッドの概要 | |
JScrollBar |
createHorizontalScrollBar()
水平スクロールバーを作成するために ScrollPaneUI の実装によって使用されます。 |
JScrollBar |
createVerticalScrollBar()
垂直スクロールバーを作成するために ScrollPaneUI の実装によって使用されます。 |
protected JViewport |
createViewport()
デフォルトで新しい JViewport を返します。 |
AccessibleContext |
getAccessibleContext()
この JComponent に関連付けられている AccessibleContext を取得します。 |
JViewport |
getColumnHeader()
列ヘッダを返します。 |
Component |
getCorner(String key)
指定されたコーナーにあるコンポーネントを返します。 |
JScrollBar |
getHorizontalScrollBar()
水平スクロールバーを返します。 |
int |
getHorizontalScrollBarPolicy()
水平スクロールバーのポリシーの値を返します。 |
JViewport |
getRowHeader()
行ヘッダを返します。 |
ScrollPaneUI |
getUI()
このコンポーネントを描画する L&F オブジェクトを返します。 |
String |
getUIClassID()
JScrollPane の Look & Feel を提供する ScrollPaneUI クラスを参照するのに使われるキーを返します。 |
JScrollBar |
getVerticalScrollBar()
垂直スクロールバーを返します。 |
int |
getVerticalScrollBarPolicy()
垂直スクロールバーのポリシーの値を返します。 |
JViewport |
getViewport()
現在の JViewport を返します。 |
Border |
getViewportBorder()
viewportBorder プロパティの値を返します。 |
Rectangle |
getViewportBorderBounds()
ビューポートボーダの境界を返します。 |
boolean |
isOpaque()
コンポーネントが範囲内のすべてのピクセルをペイントする場合に true を返します (つまり、透過バックグラウンドまたはフォアグラウンドは持たない)。 |
boolean |
isValidateRoot()
JScrollPane の子孫で revalidate() を呼び出します。 |
protected String |
paramString()
この JScrollPane の文字列表現を返します。 |
void |
setColumnHeader(JViewport columnHeader)
以前の列ヘッダがある場合はそれを削除します。 |
void |
setColumnHeaderView(Component view)
必要に応じて列ヘッダのビューポートを作成し、ビューを設定してから、列ヘッダのビューポートをスクロール区画に追加します。 |
void |
setCorner(String key,
Component corner)
スクロール区画のコーナーに表示される子を追加します (スペースがある場合)。 |
void |
setHorizontalScrollBar(JScrollBar horizontalScrollBar)
スクロール区画にビューポートの水平のビュー位置を制御するスクロールバーを追加します。 |
void |
setHorizontalScrollBarPolicy(int policy)
水平スクロールバーがスクロール区画にいつ表示されるかを設定します。 |
void |
setLayout(LayoutManager layout)
JScrollPane のレイアウトマネージャを設定します。 |
void |
setRowHeader(JViewport rowHeader)
以前の行ヘッダがある場合はそれを削除します。 |
void |
setRowHeaderView(Component view)
必要に応じて行ヘッダのビューポートを作成し、ビューを設定してから、行ヘッダのビューポートをスクロール区画に追加します。 |
void |
setUI(ScrollPaneUI ui)
コンポーネントの Look & Feel を提供する ScrollPaneUI オブジェクトを設定します。 |
void |
setVerticalScrollBar(JScrollBar verticalScrollBar)
スクロール区画にビューポートの垂直のビュー位置を制御するスクロールバーを追加します。 |
void |
setVerticalScrollBarPolicy(int policy)
垂直スクロールバーがスクロール区画にいつ表示されるかを設定します。 |
void |
setViewport(JViewport viewport)
以前のビューポートがある場合はそれを削除し、新しいビューポートのビュー位置を +x、+y 四分区間内に設定し、行および列ヘッダ (存在する場合) と新しいビューポートを同期させ、結果としてスクロールバーとヘッダと新しいビューポートを同期させます。 |
void |
setViewportBorder(Border viewportBorder)
ビューポートのボーダを追加します。 |
void |
setViewportView(Component view)
必要に応じてビューポートを作成してから、ビューを設定します。 |
void |
updateUI()
デフォルトの Look & Feel が変更されたときに呼び出されます。 |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
フィールドの詳細 |
protected int verticalScrollBarPolicy
setVerticalScrollBarPolicy(int)
protected int horizontalScrollBarPolicy
setHorizontalScrollBarPolicy(int)
protected JViewport viewport
setViewport(javax.swing.JViewport)
protected JScrollBar verticalScrollBar
setVerticalScrollBar(javax.swing.JScrollBar)
protected JScrollBar horizontalScrollBar
setHorizontalScrollBar(javax.swing.JScrollBar)
protected JViewport rowHeader
setRowHeader(javax.swing.JViewport)
protected JViewport columnHeader
setColumnHeader(javax.swing.JViewport)
protected Component lowerLeft
setCorner(java.lang.String, java.awt.Component)
protected Component lowerRight
setCorner(java.lang.String, java.awt.Component)
protected Component upperLeft
setCorner(java.lang.String, java.awt.Component)
protected Component upperRight
setCorner(java.lang.String, java.awt.Component)
コンストラクタの詳細 |
public JScrollPane(Component view, int vsbPolicy, int hsbPolicy)
vsbPolicy
が VERTICAL_SCROLLBAR_AS_NEEDED であれば、垂直スクロールバーはビューが垂直方向に収まらない場合にだけ表示されます。利用可能なポリシーの設定は setVerticalScrollBarPolicy(int)
および setHorizontalScrollBarPolicy(int)
にリストされています。view
- スクロール区画のビューポートに表示する ComponentvsbPolicy
- 垂直スクロールバーのポリシーを指定する int 値hsbPolicy
- 水平スクロールバーのポリシーを指定する int 値setViewportView(java.awt.Component)
public JScrollPane(Component view)
view
- スクロール区画のビューポートに表示する ComponentsetViewportView(java.awt.Component)
public JScrollPane(int vsbPolicy, int hsbPolicy)
setVerticalScrollBarPolicy(int)
および setHorizontalScrollBarPolicy(int)
にリストされています。vsbPolicy
- 垂直スクロールバーのポリシーを指定する int 値hsbPolicy
- 水平スクロールバーのポリシーを指定する int 値setViewportView(java.awt.Component)
public JScrollPane()
メソッドの詳細 |
public ScrollPaneUI getUI()
setUI(javax.swing.plaf.ScrollPaneUI)
public void setUI(ScrollPaneUI ui)
ui
- ScrollPaneUI L&F オブジェクトgetUI()
public void updateUI()
JComponent.updateUI()
,
UIManager.getUI(javax.swing.JComponent)
public String getUIClassID()
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public void setLayout(LayoutManager layout)
layout
- 指定するレイアウトマネージャContainer.getLayout()
,
Container.setLayout(java.awt.LayoutManager)
public boolean isOpaque()
JComponent.isOpaque()
public boolean isValidateRoot()
JComponent.revalidate()
public int getVerticalScrollBarPolicy()
setVerticalScrollBarPolicy(int)
public void setVerticalScrollBarPolicy(int policy)
getVerticalScrollBarPolicy()
public int getHorizontalScrollBarPolicy()
setHorizontalScrollBarPolicy(int)
public void setHorizontalScrollBarPolicy(int policy)
getHorizontalScrollBarPolicy()
public Border getViewportBorder()
setViewportBorder(javax.swing.border.Border)
public void setViewportBorder(Border viewportBorder)
このプロパティのデフォルト値は Look & Feel の実装によって算出されます。
getViewportBorder()
,
setViewport(javax.swing.JViewport)
public Rectangle getViewportBorderBounds()
public JScrollBar createHorizontalScrollBar()
JScrollBar
public JScrollBar getHorizontalScrollBar()
setHorizontalScrollBar(javax.swing.JScrollBar)
public void setHorizontalScrollBar(JScrollBar horizontalScrollBar)
createHorizontalScrollBar()
,
getHorizontalScrollBar()
public JScrollBar createVerticalScrollBar()
JScrollBar
public JScrollBar getVerticalScrollBar()
setVerticalScrollBar(javax.swing.JScrollBar)
public void setVerticalScrollBar(JScrollBar verticalScrollBar)
createVerticalScrollBar()
,
getVerticalScrollBar()
protected JViewport createViewport()
setViewportView
、setRowHeaderView
、および setColumnHeaderView
で (必要に応じて) ビューポートを作成するのに使います。サブクラスは、JViewport のサブクラスを返すようにこのメソッドをオーバーライドすることもできます。public JViewport getViewport()
setViewport(javax.swing.JViewport)
public void setViewport(JViewport viewport)
ほとんどのアプリケーションの場合、ビューポートとスクロール区画へのビューの追加には setViewportView を使ったほうが便利です。
createViewport()
,
getViewport()
,
setViewportView(java.awt.Component)
public void setViewportView(Component view)
JScrollPane scrollpane = new JScrollPane(); scrollpane.setViewportView(myBigComponentToScroll);アプリケーションは直接スクロール区画に子を追加してはいけません。
view
- ビューポートに追加する ComponentsetViewport(javax.swing.JViewport)
,
JViewport.setView(java.awt.Component)
public JViewport getRowHeader()
setRowHeader(javax.swing.JViewport)
public void setRowHeader(JViewport rowHeader)
ほとんどのアプリケーションの場合、スクロール区画へのヘッダコンポーネントとビューポートの追加には setRowHeaderView を使ったほうが便利です。
getRowHeader()
,
setRowHeaderView(java.awt.Component)
public void setRowHeaderView(Component view)
JScrollPane scrollpane = new JScrollPane(); scrollpane.setViewportView(myBigComponentToScroll); scrollpane.setRowHeaderView(myBigComponentsRowHeader);
view
- 行ヘッダとして表示する ComponentsetRowHeader(javax.swing.JViewport)
,
JViewport.setView(java.awt.Component)
public JViewport getColumnHeader()
setColumnHeader(javax.swing.JViewport)
public void setColumnHeader(JViewport columnHeader)
ほとんどのアプリケーションの場合、スクロール区画への行ヘッダコンポーネントとビューポートの追加には setRowHeaderView を使ったほうが便利です。
getColumnHeader()
,
setColumnHeaderView(java.awt.Component)
public void setColumnHeaderView(Component view)
JScrollPane scrollpane = new JScrollPane(); scrollpane.setViewportView(myBigComponentToScroll); scrollpane.setColumnHeaderView(myBigComponentsColumnHeader);
view
- 列ヘッダとして表示する ComponentsetColumnHeader(javax.swing.JViewport)
,
JViewport.setView(java.awt.Component)
public Component getCorner(String key)
key
値を次に示します。
setCorner(java.lang.String, java.awt.Component)
public void setCorner(String key, Component corner)
「コーナー」はどの beans プロパティシグニチャーとも一致しませんが、プロパティ名をコーナーキーに設定して PropertyChange イベントが生成されます。
key
- コンポーネントを表示するコーナーを識別corner
- 任意のコンポーネントprotected String paramString()
null
にはなりません。
JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。
public AccessibleContext getAccessibleContext()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |