ScrollPanel

优质

小牛编辑

135浏览

2023-12-01

介绍 (Introduction)

ScrollPanel小部件表示一个简单的面板，它将其内容包装在可滚动区域中。

Class 声明 (Class Declaration)

以下是com.google.gwt.user.client.ui.ScrollPanel类的声明 -

public class ScrollPanel
   extends SimplePanel
      implements SourcesScrollEvents, HasScrollHandlers,
         RequiresResize, ProvidesResize

类构造函数 (Class Constructors)

Sr.No.	构造函数和描述
1	ScrollPanel() 创建一个空滚动面板。
2	ScrollPanel(Widget child) 使用给定的子窗口小部件创建新的滚动面板。

Sr.No.

构造函数和描述

ScrollPanel()

创建一个空滚动面板。

ScrollPanel(Widget child)

使用给定的子窗口小部件创建新的滚动面板。

Class Methods

Sr.No.	功能名称和描述
1	HandlerRegistration addScrollHandler(ScrollHandler handler) 添加ScrollEvent处理程序。
2	void addScrollListener(ScrollListener listener) 已过时。请改用addScrollHandler（com.google.gwt.event.dom.client.ScrollHandler）
3	void ensureVisible(UIObject item) 通过调整面板的滚动位置，确保指定的项目可见。
4	protected Element getContainerElement() 重写此方法以指定除根元素之外的元素是面板的子窗口小部件的容器。
5	int getHorizontalScrollPosition() 获取水平滚动位置。
6	int getScrollPosition() 获取垂直滚动位置。
7	void onResize() 每当修改实现者的大小时，都必须调用此方法。
8	void removeScrollListener(ScrollListener listener) 已过时。对addScrollHandler（com.google.gwt.event.dom.client.ScrollHandler）返回的对象使用HandlerRegistration.removeHandler（）方法
9	void scrollToBottom() 滚动到此面板的底部。
10	void scrollToLeft() 滚动到此面板的最左侧。
11	void scrollToRight() 滚动到此面板的最右侧。
12	void scrollToTop() 滚动到此面板的顶部。
13	void setAlwaysShowScrollBars(boolean alwaysShow) 设置此面板是始终显示其滚动条，还是仅在必要时显示。
14	void setHeight(java.lang.String height) 设置对象的高度。
15	void setHorizontalScrollPosition(int position) 设置水平滚动位置。
16	void setScrollPosition(int position) 设置垂直滚动位置。
17	void setSize(java.lang.String width, java.lang.String height) 设置对象的大小。
18	void setWidth(java.lang.String width) 设置对象的宽度。

方法继承 (Methods Inherited)

该类继承以下类中的方法 -

com.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.Widget
com.google.gwt.user.client.ui.Panel
com.google.gwt.user.client.ui.SimplePanel
java.lang.Object

ScrollPanel小部件示例

此示例将指导您完成在GWT中显示ScrollPanel Widget的使用的简单步骤。按照以下步骤更新我们在GWT - Create Application的GWT应用程序GWT - Create Application章节 -

步	描述
1	在com. 包下创建一个名为HelloWorld的项目，如GWT - Create Application一章中所述。
2	修改HelloWorld.gwt.xml ， HelloWorld.css ， HelloWorld.html和HelloWorld.java ，如下所述。保持其余文件不变。
3	编译并运行应用程序以验证实现的逻辑的结果。

以下是修改后的模块描述符src/com.

/HelloWorld.gwt.xml 。

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <!-- Inherit the core Web Toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.User'/>
   <!-- Inherit the default GWT style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>
   <!-- Specify the app entry point class.                         -->
   <entry-point class = 'com..client.HelloWorld'/>
   <!-- Specify the paths for translatable code                    -->
   <source path = 'client'/>
   <source path = 'shared'/>
</module>

以下是修改后的样式表文件war/HelloWorld.css 。

body {
   text-align: center;
   font-family: verdana, sans-serif;
}
h1 {
   font-size: 2em;
   font-weight: bold;
   color: #777777;
   margin: 40px 0px 70px;
   text-align: center;
}

以下是修改后的HTML主机文件war/HelloWorld.html 。

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>
   <body>
      <h1>ScrollPanel Widget Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

让我们有以下Java文件src/com.

/HelloWorld.java ，它将演示ScrollPanel小部件的使用。

package com..client;
import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.DecoratorPanel;
import com.google.gwt.user.client.ui.HTML;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.ScrollPanel;
public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      // Create scrollable text 
      HTML contents = new HTML("This is a ScrollPanel."
         +" By putting some fairly large contents in the middle"
         +" and setting its size explicitly, it becomes a scrollable area"
         +" within the page, but without requiring the use of an IFRAME."
         +" Here's quite a bit more meaningless text that will serve primarily"
         +" to make this thing scroll off the bottom of its visible area."
         +" Otherwise, you might have to make it really, really"
         +" small in order to see the nifty scroll bars!");
      //create scrollpanel with content
      ScrollPanel scrollPanel = new ScrollPanel(contents);
      scrollPanel.setSize("400px", "100px");
      DecoratorPanel decoratorPanel = new DecoratorPanel();
      decoratorPanel.add(scrollPanel);
      // Add the widgets to the root panel.
      RootPanel.get().add(decoratorPanel);
   }  
}

一旦准备好完成所有更改，让我们像在GWT - 创建应用程序章节中那样在开发模式下编译和运行应用程序。如果您的应用程序一切正常，这将产生以下结果 -