CellTable

优质

小牛编辑

157浏览

2023-12-01

介绍 (Introduction)

CellTable小部件表示支持分页和列的A表格视图。

Class 声明 (Class Declaration)

以下是com.google.gwt.user.cellview.client.CellTable《T》类的声明 -

public class CellTable<T>
   extends AbstractHasData<T>

类构造函数 (Class Constructors)

Sr.No.	构造函数和描述
1	CellTable() 构造一个默认页面大小为15的表。
2	CellTable(int pageSize) 构造具有给定页面大小的表。
3	CellTable(int pageSize, CellTable.Resources resources) 使用指定的CellTable.BasicResources构造具有给定页面大小的表。
4	CellTable(int pageSize, CellTable.Resources resources, ProvidesKey《T》 keyProvider) 构造一个具有给定页面大小的表，指定的CellTable.BasicResources和给定的密钥提供程序。
5	CellTable(int pageSize, ProvidesKey《T》 keyProvider) 构造具有给定页面大小和给定密钥提供程序的表。
6	CellTable(ProvidesKey《T》 keyProvider) 构造一个默认页面大小为15的表，以及给定的密钥提供程序。

Class Methods

Sr.No.	功能名称和描述
1	void addColumn(Column《T,?》 col) 向表中添加一列。
2	void addColumn(Column《T,?》 col, Header《?》 header) 使用关联的标头向表中添加列。
3	void addColumn(Column《T,?》 col, Header《?》 header, Header《?》 footer) 使用关联的页眉和页脚向表中添加列。
4	void addColumn(Column《T,?》 col, SafeHtml headerHtml) 使用关联的SafeHtml标头向表中添加一列。
5	void addColumn(Column《T,?》 col, SafeHtml headerHtml, SafeHtml footerHtml) 使用关联的SafeHtml页眉和页脚向表中添加一列。
6	void addColumn(Column《T,?》 col, java.lang.String headerString) 使用关联的String标头向表中添加一列。
7	void add Column (Column《T,?》 col, java. lang. String header String, java.lang.String footer String) 使用关联的String页眉和页脚向表中添加一列。
8	void addColumnStyleName(int index, java.lang.String styleName) 将样式名称添加到指定索引处的TableColElement，并在必要时创建它。
9	protected Element convertToElements(SafeHtml html) 将指定的HTML转换为DOM元素并返回DOM元素的父元素。
10	protected boolean dependsOnSelection() 检查视图中的单元格是否取决于选择状态。
11	protected void do Selection (Event event, T value, int row, int column) 已过时。使用Abstract具有Data.add单元预览处理程序（com.google.gwt.view.client.Cell Preview Event.Handler）。
12	int getBodyHeight() 返回表体的高度。
13	protected Element getChildContainer() 返回保存渲染单元格的元素。
14	int getHeaderHeight() 返回表头的高度。
15	protected Element getKeyboardSelectedElement() 获取具有键盘选择的元素。
16	TableRowElement getRowElement(int row) 获取指定行的TableRowElement。
17	protected boolean isKeyboardNavigationSuppressed() 检查是否正在抑制键盘导航，例如用户正在编辑单元格时。
18	protected void onBlur() 当小部件模糊时调用。
19	protected void onBrowserEvent2(Event event) 在AbstractHasData.onBrowserEvent（Event）完成后调用。
20	protected void onFocus() 在窗口小部件聚焦时调用。
21	void redrawFooters() 重绘表格的页脚。
22	void redrawHeaders() 重绘表格的标题。
23	void removeColumn(Column《T,?》 col) 删除一列。
24	void removeColumn(int index) 删除一列。
25	void removeColumnStyleName(int index, java.lang.String styleName) 从指定索引处的TableColElement中删除样式。
26	protected void renderRowValues(SafeHtmlBuilder sb, java.util.List《T》 values, int start, SelectionModel《? super T》 selectionModel) 将所有行值渲染到指定的SafeHtmlBuilder中。
27	protected void replaceAllChildren(java.util.List《T》 values, SafeHtml html) 用指定的html替换所有子项。
28	protected boolean resetFocusOnCell() 重点关注当前关注的单元格。
29	protected void setKeyboardSelected(int index, boolean selected, boolean stealFocus) 更新元素以反映其键盘选择状态。
30	void setRowStyles(RowStyles《T》 rowStyles) 设置用于确定行样式的对象; 更改将在下次呈现表时生效。
31	protected void setSelected(Element elem, boolean selected) 已过时。 AbstractHasData从不调用此方法，在renderRowValues中渲染所选样式（SafeHtmlBuilder，List，int，SelectionModel）

方法继承 (Methods Inherited)

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

com.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.Widget
com.google.gwt.user.cellview.client.AbstractHasData
java.lang.Object

CellTable小部件示例

此示例将指导您完成在GWT中显示CellTable 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>CellTable Widget Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

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

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

package com..client;
import java.util.Arrays;
import java.util.Date;
import java.util.List;
import com.google.gwt.cell.client.DateCell;
import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.cellview.client.CellTable;
import com.google.gwt.user.cellview.client.Column;
import com.google.gwt.user.cellview.client
.HasKeyboardSelectionPolicy.KeyboardSelectionPolicy;
import com.google.gwt.user.cellview.client.TextColumn;
import com.google.gwt.user.client.Window;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.VerticalPanel;
import com.google.gwt.view.client.SelectionChangeEvent;
import com.google.gwt.view.client.SingleSelectionModel;
public class HelloWorld implements EntryPoint {
   /**
    * A simple data type that represents a contact.
    */
   private static class Contact {
      private final String address;
      private final Date birthday;
      private final String name;
      public Contact(String name, Date birthday, String address) {
         this.name = name;
         this.birthday = birthday;
         this.address = address;
      }
   }
   /**
    * The list of data to display.
    */
   private static final List<Contact> CONTACTS = Arrays.asList(
      new Contact("John", new Date(80, 4, 12), "123 Fourth Avenue"),
      new Contact("Joe", new Date(85, 2, 22), "22 Lance Ln"),
      new Contact("George",new Date(46, 6, 6),"1600 Pennsylvania Avenue"));
   public void onModuleLoad() {
      // Create a CellTable.
      CellTable<Contact> table = new CellTable<Contact>();
      table.setKeyboardSelectionPolicy(KeyboardSelectionPolicy.ENABLED);
      // Add a text column to show the name.
      TextColumn<Contact> nameColumn = 
      new TextColumn<Contact>() {
         @Override
         public String getValue(Contact object) {
            return object.name;
         }
      };
      table.addColumn(nameColumn, "Name");
      // Add a date column to show the birthday.
      DateCell dateCell = new DateCell();
      Column<Contact, Date> dateColumn 
      = new Column<Contact, Date>(dateCell) {
         @Override
         public Date getValue(Contact object) {
            return object.birthday;
         }
      };
      table.addColumn(dateColumn, "Birthday");
      // Add a text column to show the address.
      TextColumn<Contact> addressColumn 
      = new TextColumn<Contact>() {
         @Override
         public String getValue(Contact object) {
            return object.address;
         }
      };
      table.addColumn(addressColumn, "Address");
      // Add a selection model to handle user selection.
      final SingleSelectionModel<Contact> selectionModel 
      = new SingleSelectionModel<Contact>();
      table.setSelectionModel(selectionModel);
      selectionModel.addSelectionChangeHandler(
      new SelectionChangeEvent.Handler() {
         public void onSelectionChange(SelectionChangeEvent event) {
            Contact selected = selectionModel.getSelectedObject();
            if (selected != null) {
               Window.alert("You selected: " + selected.name);
            }
         }
      });
      // Set the total row count. This isn't strictly necessary,
      // but it affects paging calculations, so its good habit to
      // keep the row count up to date.
      table.setRowCount(CONTACTS.size(), true);
      // Push the data into the widget.
      table.setRowData(0, CONTACTS);
      VerticalPanel panel = new VerticalPanel();
      panel.setBorderWidth(1);	    
      panel.setWidth("400");
      panel.add(table);
      // Add the widgets to the root panel.
      RootPanel.get().add(panel);
   }
}

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