FormPanel

优质

小牛编辑

135浏览

2023-12-01

介绍 (Introduction)

FormPanel小部件表示将其内容包装在HTML“FORM”元素中的面板。

Class 声明 (Class Declaration)

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

public class FormPanel
   extends SimplePanel
      implements FiresFormEvents, 
         com.google.gwt.user.client.ui.impl.FormPanelImplHost

类构造函数 (Class Constructors)

Sr.No.	构造函数和描述
1	FormPanel() 创建一个新的FormPanel。
2	protected FormPanel(Element element) 子类可以使用此构造函数来显式使用现有元素。
3	protected FormPanel(Element element, boolean createIFrame) 子类可以使用此构造函数来显式使用现有元素。
4	FormPanel(NamedFrame frameTarget) 创建一个以NamedFrame为目标的FormPanel。
5	FormPanel(java.lang.String target) 创建一个新的FormPanel。

Class Methods

Sr.No.	功能名称和描述
1	void add Form Handler (FormHandler handler) 已过时。使用添加提交完整处理程序（com.google.gwt.user.client.ui.Form Panel.Submit Complete Handler）并添加Submit Handler（com.google.gwt.user.client.ui.Form Panel.Submit Handler）
2	Handler Registration addSubmit Complete Handler (FormPanel.SubmitCompleteHandler handler) 添加FormPanel.Submit完成事件处理程序。
3	HandlerRegistration addSubmitHandler(FormPanel.SubmitHandler handler) 添加FormPanel.SubmitEvent处理程序。
4	java.lang.String getAction() 获取与此表单关联的“操作”。
5	java.lang.String getEncoding() 获取用于提交此表单的编码。
6	java.lang.String getMethod() 获取用于提交此表单的HTTP方法。
7	java.lang.String getTarget() 获取表单的“目标”。
8	protected void onAttach() 当窗口小部件附加到浏览器的文档时，将调用此方法。
9	protected void onDetach() 当窗口小部件与浏览器的文档分离时，将调用此方法。
10	boolean onFormSubmit() 提交表单时触发。
11	void onFrameLoad()
12	void removeFormHandler(FormHandler handler) 已过时。对返回的对象使用HandlerRegistration.removeHandler（）方法，然后添加* Handler方法
13	void reset() 重置表单，清除所有字段。
14	void setAction(java.lang.String url) 设置与此表单关联的“操作”。
15	void setEncoding(java.lang.String encodingType) 设置用于提交此表单的编码。
16	void setMethod(java.lang.String method) 设置用于提交此表单的HTTP方法。
17	void submit() 提交表格。
18	static FormPanel wrap(Element element) 创建一个包装现有元素的FormPanel。
19	static FormPanel wrap(Element element, boolean createIFrame) 创建一个包装现有元素的FormPanel。

方法继承 (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

FormPanel小部件示例

此示例将指导您完成在GWT中显示FormPanel窗口小部件的使用的简单步骤。按照以下步骤更新我们在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>FormPanel Widget Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

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

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

package com..client;
import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.event.dom.client.ClickEvent;
import com.google.gwt.event.dom.client.ClickHandler;
import com.google.gwt.user.client.Window;
import com.google.gwt.user.client.ui.Button;
import com.google.gwt.user.client.ui.DecoratorPanel;
import com.google.gwt.user.client.ui.FileUpload;
import com.google.gwt.user.client.ui.FormPanel;
import com.google.gwt.user.client.ui.FormPanel.SubmitCompleteEvent;
import com.google.gwt.user.client.ui.FormPanel.SubmitEvent;
import com.google.gwt.user.client.ui.ListBox;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.TextBox;
import com.google.gwt.user.client.ui.VerticalPanel;
public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      // Create a FormPanel and point it at a service.
      final FormPanel form = new FormPanel();
      form.setAction("/myFormHandler");
      // Because we're going to add a FileUpload widget, 
      // we'll need to set the form to use the POST method, 
      // and multipart MIME encoding.
      form.setEncoding(FormPanel.ENCODING_MULTIPART);
      form.setMethod(FormPanel.METHOD_POST);
      // Create a panel to hold all of the form widgets.
      VerticalPanel panel = new VerticalPanel();
      panel.setSpacing(10);
      form.setWidget(panel);
      // Create a TextBox, giving it a name so that it will be submitted.
      final TextBox tb = new TextBox();
      tb.setWidth("220");
      tb.setName("textBoxFormElement");
      panel.add(tb);
      // Create a ListBox, giving it a name and 
      // some values to be associated with its options.
      ListBox lb = new ListBox();
      lb.setName("listBoxFormElement");
      lb.addItem("item1", "item1");
      lb.addItem("item2", "item2");
      lb.addItem("item3", "item3");
      lb.setWidth("220");
      panel.add(lb);
      // Create a FileUpload widget.
      FileUpload upload = new FileUpload();
      upload.setName("uploadFormElement");
      panel.add(upload);
      // Add a 'submit' button.
      panel.add(new Button("Submit", new ClickHandler() {
         @Override
         public void onClick(ClickEvent event) {
            form.submit();					
         }
      }));
      // Add an event handler to the form.
      form.addSubmitHandler(new FormPanel.SubmitHandler() {
         @Override
         public void onSubmit(SubmitEvent event) {
            // This event is fired just before the form is submitted. 
            // We can take this opportunity to perform validation.
            if (tb.getText().length() == 0) {
               Window.alert("The text box must not be empty");
               event.cancel();
            }					
         }
      });
      form.addSubmitCompleteHandler(new FormPanel.SubmitCompleteHandler() {
         @Override
         public void onSubmitComplete(SubmitCompleteEvent event) {
            // When the form submission is successfully completed,
            // this event is fired. Assuming the service returned 
            // a response of type text/html, we can get the result
            // here.
            Window.alert(event.getResults());					
         }
      });
      DecoratorPanel decoratorPanel = new DecoratorPanel();
      decoratorPanel.add(form);
      // Add the widgets to the root panel.
      RootPanel.get().add(decoratorPanel);
   }
}

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