| java.lang.Object
 org.wings.SComponent
org.wings.SContainer
org.wings.SForm
All known Subclasses: org.wings.SWindow, org.wings.CmsForm,
| SForm | | public class SForm extends SContainer implements LowLevelEventListener(Code) | | Container in which you need to wrap HTML input fields (ie. STextField)
to work correctly.
The browser uses this object/tag to identify how (POST or GET) and where
to send an request originating from any input inside this form.
Note:Please be aware, that some components render differently if
placed inside a SForm.
author:
Armin Haaf |
| Constructor Summary | |
| public | SForm()
Create a standard form component. | | public | SForm(URL action)
Create a standard form component but redirects the request to the passed
URL. | | public | SForm(SLayoutManager layout)
Create a standard form component. |
| fileChooserCount | | int fileChooserCount(Code) | | |
| SForm | | public SForm()(Code) | | Create a standard form component.
|
| SForm | | public SForm(URL action)(Code) | | Create a standard form component but redirects the request to the passed
URL. Use this i.e. to address other servlets.
Parameters:
action - The target URL. |
| SForm | | public SForm(SLayoutManager layout)(Code) | | Create a standard form component.
Parameters:
layout - The layout to apply to this container.
See Also: SContainer |
| addActionListener | | public void addActionListener(ActionListener listener)(Code) | | Add a listener for Form events. A Form event is always triggered, when
a form has been submitted. Usually, this happens, whenever a submit
button is pressed or some other mechanism triggered the posting of the
form. Other mechanisms are
- Java Script submit() event
- If a form contains a single text input, then many browsers
submit the form, if the user presses RETURN in that field. In that
case, the submit button will not receive any event but
only the form.
- The
SFileChooser will trigger a form event, if the file
size exceeded the allowed size. In that case, even if the submit
button has been pressed, no submit-button event will be triggered.
(For details, see
SFileChooser ).
Form events are guaranteed to be triggered after all
Selection-Changes and Button ActionListeners.
|
| clearArmedComponents | | public static void clearArmedComponents()(Code) | | clear armed components. This is usually not necessary, since sessions
clear clear their armed components. But if there was some Exception, it
might well be, that this does not happen.
|
| fireActionPerformed | | protected void fireActionPerformed(String pActionCommand)(Code) | | Fire a ActionEvent at each registered listener.
|
| fireEvents | | public static void fireEvents()(Code) | | This method fires the low level events for all "armed" components of
this thread (http session) in an ordered manner:
- forms
- buttons / clickables
- "regular" components
This order derives out of the assumption, that a user first modifies
regular components before he presses the button submitting his changes.
Otherwise button actions would get fired before the edit components
fired their events.
|
| fireFinalEvents | | public void fireFinalEvents()(Code) | | |
| fireIntermediateEvents | | public void fireIntermediateEvents()(Code) | | |
| getEncodingType | | public String getEncodingType()(Code) | | Get the current encoding type, as set with
SForm.setEncodingType(String) . If no encoding type was set, this
method detects the best encoding type. This can be expensive, so if
you can, set the encoding type.
string containing the encoding type. This is something likemultipart/form-data,application/x-www-form-urlencoded .. or 'null'by default. |
| isPostMethod | | public boolean isPostMethod()(Code) | | Returns, whether this form is transmitted via POST (true)
or GET (false).
Default is true.
true if form postedt via POST,false if via GET (false). |
| processLowLevelEvent | | public void processLowLevelEvent(String action, String[] values)(Code) | | |
| setAction | | public void setAction(URL action)(Code) | | |
| setActionCommand | | public void setActionCommand(String actionCommand)(Code) | | A SForm fires an event each time it was triggered (i.e. pressing asubmit button inside)
Parameters:
actionCommand - The action command to place insiside the ActionEvent |
| setDefaultButton | | public void setDefaultButton(SButton defaultButton)(Code) | | Set the default button activated upon enter.
The button is triggered if you press enter inside a form to submit it.
Parameters:
defaultButton - A button which will be rendered invisible.If null enter key pressed will be catched by the wings framework. |
| setEncodingType | | public void setEncodingType(String type)(Code) | | Set the encoding of this form. This actually is an HTML interna
that bubbles up here. By default, the encoding type of any HTML-form
is application/x-www-form-urlencoded, and as such, needn't
be explicitly set with this setter. However, if you've included a
file upload element (as represented by
SFileChooser ) in your
form, this must be set to multipart/form-data, since only
then, files are transmitted correctly. In 'normal' forms without
file upload, it is not necessary to set it to
multipart/form-data; actually it enlarges the data to
be transmitted, so you probably don't want to do this, then.
Parameters:
type - the encoding type; one of multipart/form-data,application/x-www-form-urlencoded or null to detect encoding. |
| setPostMethod | | public void setPostMethod(boolean postMethod)(Code) | | Set, whether this form is to be transmitted via POST (true)
or GET (false). The default, and this is what you
usually want, is POST.
|
| Methods inherited from org.wings.SContainer | public SComponent add(SComponent c)(Code)(Java Doc)
public void add(SComponent c, Object constraint)(Code)(Java Doc)
public SComponent add(SComponent c, int index)(Code)(Java Doc)
public void add(SComponent c, Object constraint, int index)(Code)(Java Doc)
public SComponent addComponent(SComponent c)(Code)(Java Doc)
public SComponent addComponent(SComponent c, Object constraint)(Code)(Java Doc)
public SComponent addComponent(SComponent c, int index)(Code)(Java Doc)
public SComponent addComponent(SComponent c, Object constraint, int index)(Code)(Java Doc)
public void addContainerListener(SContainerListener l)(Code)(Java Doc)
public void addNotify()(Code)(Java Doc)
public Object clone()(Code)(Java Doc)
protected void fireContainerEvent(int type, SComponent comp)(Code)(Java Doc)
public SComponent getComponent(int i)(Code)(Java Doc)
public int getComponentCount()(Code)(Java Doc)
protected ArrayList getComponentList()(Code)(Java Doc)
public SComponent[] getComponents()(Code)(Java Doc)
public Object getConstraintAt(int i)(Code)(Java Doc)
protected ArrayList getConstraintList()(Code)(Java Doc)
public SLayoutManager getLayout()(Code)(Java Doc)
public void invite(ComponentVisitor visitor) throws Exception(Code)(Java Doc)
public void inviteEachComponent(ComponentVisitor visitor) throws Exception(Code)(Java Doc)
protected boolean isShowingChildren()(Code)(Java Doc)
protected void processContainerEvent(SContainerListener listener, SContainerEvent e)(Code)(Java Doc)
public void remove(SComponent c)(Code)(Java Doc)
public void remove(int index)(Code)(Java Doc)
public void removeAll()(Code)(Java Doc)
public void removeContainerListener(SContainerListener l)(Code)(Java Doc)
public void removeNotify()(Code)(Java Doc)
public void setCG(ContainerCG cg)(Code)(Java Doc)
public void setLayout(SLayoutManager l)(Code)(Java Doc)
protected void setParentFrame(SFrame f)(Code)(Java Doc)
public void updateCG()(Code)(Java Doc)
|
| Methods inherited from org.wings.SComponent | final public void addComponentListener(SComponentListener l)(Code)(Java Doc)
public void addDynamicStyle(Style style)(Code)(Java Doc)
final protected void addEventListener(Class<T> type, T listener)(Code)(Java Doc)
public void addNotify()(Code)(Java Doc)
final public void addParentFrameListener(SParentFrameListener l)(Code)(Java Doc)
final public void addRenderListener(SRenderListener renderListener)(Code)(Java Doc)
final public void addScriptListener(ScriptListener listener)(Code)(Java Doc)
public void addStyle(String additionalCssClassName)(Code)(Java Doc)
public Object clone()(Code)(Java Doc)
protected void fireComponentChangeEvent(SComponentEvent aEvent)(Code)(Java Doc)
public void fireFinalEvents()(Code)(Java Doc)
protected void fireKeyEvents()(Code)(Java Doc)
final public void fireRenderEvent(int type)(Code)(Java Doc)
public ActionMap getActionMap()(Code)(Java Doc)
public Color getBackground()(Code)(Java Doc)
public SBorder getBorder()(Code)(Java Doc)
public ComponentCG getCG()(Code)(Java Doc)
final public Object getClientProperty(Object key)(Code)(Java Doc)
public SPopupMenu getComponentPopupMenu()(Code)(Java Doc)
public Style getDynamicStyle(Selector selector)(Code)(Java Doc)
public Collection getDynamicStyles()(Code)(Java Doc)
public int getFocusTraversalIndex()(Code)(Java Doc)
public SFont getFont()(Code)(Java Doc)
public Color getForeground()(Code)(Java Doc)
public int getHorizontalAlignment()(Code)(Java Doc)
public InputMap getInputMap()(Code)(Java Doc)
public InputMap getInputMap(int condition)(Code)(Java Doc)
final protected int getListenerCount(Class type)(Code)(Java Doc)
final protected Object[] getListenerList()(Code)(Java Doc)
final public EventListener[] getListeners(Class<? extends EventListener> type)(Code)(Java Doc)
public String getLowLevelEventId()(Code)(Java Doc)
final public String getName()(Code)(Java Doc)
final public SContainer getParent()(Code)(Java Doc)
public SFrame getParentFrame()(Code)(Java Doc)
public SDimension getPreferredSize()(Code)(Java Doc)
public RequestURL getRequestURL()(Code)(Java Doc)
public boolean getResidesInForm()(Code)(Java Doc)
public List<ScriptListener> getScriptListenerList()(Code)(Java Doc)
public ScriptListener[] getScriptListeners()(Code)(Java Doc)
final public Session getSession()(Code)(Java Doc)
public boolean getShowAsFormComponent()(Code)(Java Doc)
public String getStyle()(Code)(Java Doc)
public String getToolTipText()(Code)(Java Doc)
public int getVerticalAlignment()(Code)(Java Doc)
public void invite(ComponentVisitor visitor) throws Exception(Code)(Java Doc)
protected static boolean isDifferent(Object oldObject, Object newObject)(Code)(Java Doc)
public boolean isEnabled()(Code)(Java Doc)
public boolean isFocusOwner()(Code)(Java Doc)
public boolean isRecursivelyVisible()(Code)(Java Doc)
public boolean isReloadForced()(Code)(Java Doc)
protected boolean isUpdatePossible()(Code)(Java Doc)
public boolean isVisible()(Code)(Java Doc)
protected String paramString()(Code)(Java Doc)
protected void processComponentEvent(SComponentListener listener, SComponentEvent e)(Code)(Java Doc)
protected boolean processKeyEvents(String[] values)(Code)(Java Doc)
protected void processLowLevelEvent(String name, String[] values)(Code)(Java Doc)
final public void putClientProperty(Object key, Object value)(Code)(Java Doc)
final void register()(Code)(Java Doc)
public void reload()(Code)(Java Doc)
final protected void reloadIfChange(Object oldVal, Object newVal)(Code)(Java Doc)
final protected void reloadIfChange(int oldVal, int newVal)(Code)(Java Doc)
final protected void reloadIfChange(boolean oldVal, boolean newVal)(Code)(Java Doc)
final protected void reloadIfChange(byte oldVal, byte newVal)(Code)(Java Doc)
final protected void reloadIfChange(short oldVal, short newVal)(Code)(Java Doc)
final protected void reloadIfChange(long oldVal, long newVal)(Code)(Java Doc)
final protected void reloadIfChange(float oldVal, float newVal)(Code)(Java Doc)
final protected void reloadIfChange(double oldVal, double newVal)(Code)(Java Doc)
final protected void reloadIfChange(char oldVal, char newVal)(Code)(Java Doc)
final public void removeComponentListener(SComponentListener l)(Code)(Java Doc)
public void removeDynamicStyle(Selector selector)(Code)(Java Doc)
final protected void removeEventListener(Class<T> type, T listener)(Code)(Java Doc)
public void removeNotify()(Code)(Java Doc)
final public void removeParentFrameListener(SParentFrameListener l)(Code)(Java Doc)
final public void removeRenderListener(SRenderListener renderListener)(Code)(Java Doc)
final public void removeScriptListener(ScriptListener listener)(Code)(Java Doc)
public void removeStyle(String cssStyleClassName)(Code)(Java Doc)
public void requestFocus()(Code)(Java Doc)
public void scrollRectToVisible(Rectangle aRect)(Code)(Java Doc)
public void setActionMap(ActionMap actionMap)(Code)(Java Doc)
public void setAttribute(String cssPropertyName, String value)(Code)(Java Doc)
public void setAttribute(CSSProperty property, String propertyValue)(Code)(Java Doc)
public void setAttribute(Selector selector, CSSProperty property, String propertyValue)(Code)(Java Doc)
public void setAttribute(Selector selector, CSSProperty property, SIcon icon)(Code)(Java Doc)
public void setAttribute(Selector selector, CSSProperty property, Color color)(Code)(Java Doc)
public void setAttributes(Selector selector, CSSAttributeSet attributes)(Code)(Java Doc)
public void setBackground(Color color)(Code)(Java Doc)
public void setBorder(SBorder border)(Code)(Java Doc)
public void setCG(ComponentCG newCG)(Code)(Java Doc)
public void setComponentPopupMenu(SPopupMenu popupMenu)(Code)(Java Doc)
public void setDynamicStyles(Collection dynamicStyles)(Code)(Java Doc)
public void setEnabled(boolean enabled)(Code)(Java Doc)
public void setFocusTraversalIndex(int index)(Code)(Java Doc)
public void setFont(SFont font)(Code)(Java Doc)
public void setForeground(Color color)(Code)(Java Doc)
public void setHorizontalAlignment(int alignment)(Code)(Java Doc)
public void setInputMap(InputMap inputMap)(Code)(Java Doc)
public void setInputMap(int condition, InputMap inputMap)(Code)(Java Doc)
public void setName(String uniqueName)(Code)(Java Doc)
public void setNameRaw(String uncheckedName)(Code)(Java Doc)
public void setParent(SContainer parent)(Code)(Java Doc)
protected void setParentFrame(SFrame parentFrame)(Code)(Java Doc)
public void setPreferredSize(SDimension preferredSize)(Code)(Java Doc)
public void setReloadForced(boolean forced)(Code)(Java Doc)
public void setShowAsFormComponent(boolean showAsFormComponent)(Code)(Java Doc)
public void setStyle(String cssClassName)(Code)(Java Doc)
public void setToolTipText(String t)(Code)(Java Doc)
public void setVerticalAlignment(int alignment)(Code)(Java Doc)
public void setVisible(boolean visible)(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final void unregister()(Code)(Java Doc)
public void update(Update update)(Code)(Java Doc)
public void updateCG()(Code)(Java Doc)
public void write(Device s) throws IOException(Code)(Java Doc)
|
|
|