Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

com.openwave.oui.waomelements
Class Form  view Form download Form.java

java.lang.Object
  extended bycom.openwave.oui.framework.WaomElement
      extended bycom.openwave.oui.framework.WaomComposite
          extended bycom.openwave.oui.waomelements.AbsCard
              extended bycom.openwave.oui.waomelements.Form
All Implemented Interfaces:
java.io.Serializable

public class Form
extends AbsCard

At times, applications require users to insert several pieces of information. In these cases you should use a form. There are two kinds of forms: elective forms and wizards. Elective forms present multiple entry fields for the user to fill in the same card while wizards collect information from users, one step at the time.
If you wonder which kind of form offers better usability, the answer is: "it depends". Users of the Nokia 7110 find elective forms intuitive (in spite of the high number of clicks required to operate them), while users of UP.Browser find wizards more intuitive.
The Form object will let you define a form that will render as the most usable construct on each device.
Creation date: (4/4/2001 12:57:36 PM)


Field Summary
private  boolean formIsElectiveOnUPText
           
protected  java.lang.String longTitle
           
private static long serialVersionUID
           
 
Fields inherited from class com.openwave.oui.waomelements.AbsCard
currentParagraph, enforceLinks, isInParagraph, onenterbackwardURL, onenterforwardURL, ontimerURL, shortTitle
 
Fields inherited from class com.openwave.oui.framework.WaomElement
 
Constructor Summary
(package private) Form()
          Card constructor.
  Form(java.lang.String id, java.lang.String shortTitle)
          Card constructor.
 
Method Summary
 void addElement(com.openwave.oui.framework.WaomElement element)
          Add an element to the form
 void addMenu(Menu menu)
           
 void addSecondaryPath(java.lang.String URL, java.lang.String shortName)
          This is the short form for defining a Secondary path activity.
 void addSecondaryPath(java.lang.String URL, java.lang.String shortName, java.lang.String longName)
          This is the short form for defining a Secondary path activity.
 void addSecondaryPathTask(AbsTask absTask, java.lang.String shortName)
          This is the short form for defining a Secondary path activity.
 void addSecondaryPathTask(AbsTask absTask, java.lang.String shortName, java.lang.String longName)
          As corresponding method above.
 void addSidePath(java.lang.String URL, java.lang.String shortName)
          Define a side-path activity.
 void addSidePath(java.lang.String URL, java.lang.String shortName, java.lang.String longName)
          Define a side-path activity.
 void addSidePathTask(AbsTask absTask, java.lang.String shortName)
          Define a side-path activity.
 void addSidePathTask(AbsTask absTask, java.lang.String shortName, java.lang.String longName)
          As corresponding method above.
 java.lang.String getId()
          Insert the method's description here.
 boolean isForm()
           
 boolean isFormElectiveOnUPText()
           
 void makeFormElectiveOnUPText()
          Forces the UP.Browser to show the form as an elective form.
 void setId(java.lang.String id)
          Sets card ID.
 void setPrimaryPath(java.lang.String URL, java.lang.String shortName)
          This is the short form for defining a main path activity.
 void setPrimaryPath(java.lang.String URL, java.lang.String shortName, java.lang.String longName)
          This is the short form for defining a main path activity.
 void setPrimaryPathTask(AbsTask absTask, java.lang.String shortName)
          This is the short form for defining a main path activity.
 void setPrimaryPathTask(AbsTask absTask, java.lang.String shortName, java.lang.String longName)
          Activity can be any task.
 void setTaskMenu(TaskMenu taskMenu)
           
 void visit(com.openwave.oui.framework.WaomVisitor wv)
           
 
Methods inherited from class com.openwave.oui.waomelements.AbsCard
addText, alignCenter, alignLeft, alignRight, areLinksEnforced, beginParagraph, beginParagraph, beginParagraph, containsWidget, endParagraph, enforceLogicalBack, enforceNavigationWithLinks, enforceTitle, getAccesskey, getCurrentParagraph, getEnforceTitle, getNewcontext, getNumberOfWidgets, getOnenterbackward, getOnenterforward, getOntimer, getOrdered, getTitle, isAbsCard, setEnforceTitle, setNewcontext, setOnenterbackward, setOnenterforward, setOntimer, setOrdered, setTitle
 
Methods inherited from class com.openwave.oui.framework.WaomElement
addTo, clearChildren, getChildren, getClassValue, getDirectDefinition, getIdValue, getParent, getWaomElementName, isAppendix, isBodyPager, isCaller, isCard, isComboMenu, isConditionalCard, isDeck, isHead, isInRawMode, isOnevent, isOption, isParagraph, isPathTask, isTask, isTaskMenu, isTemplate, isTimer, isWidget, render, setClassValue, setDirectDefinition, setIdValue, setToRawMode, setWaomElementName
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

longTitle

protected java.lang.String longTitle

formIsElectiveOnUPText

private boolean formIsElectiveOnUPText

serialVersionUID

private static final long serialVersionUID
See Also:
Constant Field Values
Constructor Detail

Form

Form()
Card constructor. Sets waomElementName = "Card"


Form

public Form(java.lang.String id,
            java.lang.String shortTitle)
Card constructor. Sets waomElementName = "Card"

Method Detail

getId

public java.lang.String getId()
Insert the method's description here. Creation date: (4/4/2001 2:00:59 PM)


setId

public void setId(java.lang.String id)
Sets card ID. Creation date: (4/4/2001 2:00:59 PM)


addSecondaryPath

public void addSecondaryPath(java.lang.String URL,
                             java.lang.String shortName,
                             java.lang.String longName)
This is the short form for defining a Secondary path activity. It assumes that a URL is all you need to move on. If you need to pass along some values to the server by means of postfields, you will need to use the addSecondaryPathTask().
This method will cause navigation to be supported in the form of a hyperlink on Nokia phones and through softkeys on UP.Browser.


addSidePath

public void addSidePath(java.lang.String URL,
                        java.lang.String shortName,
                        java.lang.String longName)
Define a side-path activity. This method will cause navigation to be supported in the option menu on Nokia phones and through softkeys on UP.Browser.


addElement

public void addElement(com.openwave.oui.framework.WaomElement element)
Add an element to the form

Overrides:
addElement in class AbsCard

addMenu

public void addMenu(Menu menu)

addSecondaryPath

public void addSecondaryPath(java.lang.String URL,
                             java.lang.String shortName)
This is the short form for defining a Secondary path activity. It assumes that a URL is all you need to move on. If you need to pass along some values to the server by means of postfields, you will need to use the addSecondaryPathTask(). This method will cause navigation to be supported in the form of a hyperlink on Nokia phones and through softkeys on UP.Browser.


addSecondaryPathTask

public void addSecondaryPathTask(AbsTask absTask,
                                 java.lang.String shortName)
This is the short form for defining a Secondary path activity.


addSecondaryPathTask

public void addSecondaryPathTask(AbsTask absTask,
                                 java.lang.String shortName,
                                 java.lang.String longName)
As corresponding method above. Activity can be a task.


addSidePath

public void addSidePath(java.lang.String URL,
                        java.lang.String shortName)
Define a side-path activity. This method will cause navigation to be supported in the option menu on Nokia phones and through softkeys on UP.Browser.


addSidePathTask

public void addSidePathTask(AbsTask absTask,
                            java.lang.String shortName)
Define a side-path activity.


addSidePathTask

public void addSidePathTask(AbsTask absTask,
                            java.lang.String shortName,
                            java.lang.String longName)
As corresponding method above. Activity can be a task.


isForm

public boolean isForm()

isFormElectiveOnUPText

public boolean isFormElectiveOnUPText()

makeFormElectiveOnUPText

public void makeFormElectiveOnUPText()
Forces the UP.Browser to show the form as an elective form.


setPrimaryPath

public void setPrimaryPath(java.lang.String URL,
                           java.lang.String shortName)
This is the short form for defining a main path activity. It assumes that a URL is all you need to move on. If you need to pass along some values to the server by means of postfields, you will need to use the setPrimaryPathTask().
This method will cause navigation to be supported in the form of a hyperlink on Nokia phones and through softkeys on UP.Browser.


setPrimaryPath

public void setPrimaryPath(java.lang.String URL,
                           java.lang.String shortName,
                           java.lang.String longName)
This is the short form for defining a main path activity. It assumes that a URL is all you need to move on. If you need to pass along some values to the server by means of postfields, you will need to use the setPrimaryPathTask().
This method will cause navigation to be supported in the form of a hyperlink on Nokia phones and through softkeys on UP.Browser.


setPrimaryPathTask

public void setPrimaryPathTask(AbsTask absTask,
                               java.lang.String shortName)
This is the short form for defining a main path activity.


setPrimaryPathTask

public void setPrimaryPathTask(AbsTask absTask,
                               java.lang.String shortName,
                               java.lang.String longName)
Activity can be any task.


setTaskMenu

public void setTaskMenu(TaskMenu taskMenu)

visit

public void visit(com.openwave.oui.framework.WaomVisitor wv)
Overrides:
visit in class AbsCard