介紹
javax.swing 類 JScrollPane
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JScrollPane
•所有已實現的接口:
•ImageObserver, MenuContainer, Serializable, Accessible, ScrollPaneConstants
JViewport 為數據源提供一個視窗或“視口”,例如,一個文本檔案。該數據源為由 JViewport 視圖顯示的“scrollable 客戶端”(即數據模型)。JScrollPane 基本上由 JScrollBar、一個 JViewport 以及它們之間的連線組成,如右圖所示。
在兩個滾動條的交匯處、行標題與列標題的交匯處,或者滾動條與其中一個標題的交匯處,兩個組件在很接近角的地方停止,留下一個默認情況下為空的矩形空間。四個角都有可能存在這些空間。在上圖中,右上角存在該空間,由標籤“角組件”標識。
可使用 setCorner 方法替換許多的這些空白空間,以便將組件添加到一個特定角。(註:相同的組件不能添加到多個角。)如果想要為滾動窗格增加一些額外的裝飾或功能,那么此方法很有用。每個角組件的大小都完全由標題和/或包圍它的滾動條的大小確定。
只有角組件存在於其中的角中有空白空間時該角組件才是可見的。例如,構想一個設定在滾動窗格(帶有列標題)右上角的組件。如果滾動窗格的垂直滾動條不存在(可能因為視圖組件尚未大到需要它的地步),那么該角組件將不會顯示(因為標題和垂直滾動條的交匯點所創建的角中沒有空白空間)。要強制使滾動條始終顯示,可使用 setVerticalScrollBarPolicy(VERTICAL_SCROLLBAR_ALWAYS) 確保該角組件的空間始終存在。
要圍繞主視口添加一個邊界,可使用 setViewportBorder。(當然,也可以使用 setBorder 圍繞整個滾動窗格添加一個邊界。)
應該執行的一個常見操作是設定背景顏色,此顏色可在主視口小於視口或透明時使用。使用 scrollPane.getViewport().setBackground() 設定視口的背景色可實現此目的。設定視口而不是滾動窗格的顏色的原因是,默認情況下,JViewport 為不透明,還有一些其他屬性,這意味著它將用其背景色完全填充背景。因此當 JScrollPane 繪製其背景時,視口通常將在它上面繪製。
默認情況下,JScrollPane 使用 ScrollPaneLayout 處理其子組件的布局。ScrollPaneLayout 使用以下兩個方法之一確定視口視圖的大小:
如果視圖實現了 Scrollable,將使用getPreferredScrollableViewportSize、getScrollableTracksViewportWidth 和 getScrollableTracksViewportHeight 的組合。
否則使用getPreferredSize
1.如果視圖實現了 Scrollable,將使用getPreferredScrollableViewportSize、getScrollableTracksViewportWidth 和 getScrollableTracksViewportHeight 的組合。
2.否則使用getPreferredSize
警告:Swing 不是執行緒安全的。有關更多信息,請參閱 Swing's Threading Policy。
警告:此類的序列化對象與以後的 Swing 版本不兼容。當前序列化支持適用於短期存儲,或適用於在運行相同 Swing 版本的應用程式之間進行 RMI(Remote Method Invocation,遠程方法調用)。從 1.4 版本開始,已在 java.beans 包中添加了支持所有 JavaBeans 長期存儲的功能。請參見 XMLEncoder。
另請參見:
JScrollBar, JViewport, ScrollPaneLayout, Scrollable, Component.getPreferredSize(), setViewportView(java.awt.Component), setRowHeaderView(java.awt.Component), setColumnHeaderView(java.awt.Component), setCorner(java.lang.String, java.awt.Component), setViewportBorder(javax.swing.border.Border)