Class Button

java.lang.Object
com.meterware.httpunit.FormControl
com.meterware.httpunit.Button
All Implemented Interfaces:
HTMLElement, ScriptingEventHandler
Direct Known Subclasses:
ResetButton, SubmitButton
public class Button extends FormControl
A button in a form.
Author:
Russell Gold

  • Field Details

  • Method Details

    • getType

      public String getType()
      Description copied from class: FormControl
      Return the type of the control, as seen from JavaScript.
      Specified by:
      getType in class FormControl

    • getValue

      public String getValue()
      Returns the value associated with this button.

    • doOnClickSequence

      protected boolean doOnClickSequence(int x, int y) throws IOException, SAXException
      the onClickSequence for this button
      Returns:
      true if the even was handled
      Throws:
      IOException
      SAXException

    • click

      public void click() throws IOException, SAXException
      Performs the action associated with clicking this button after running any 'onClick' script. For a submit button this typically submits the form.
      Throws:
      IOException
      SAXException

    • rememberEnableState

      public void rememberEnableState()
      remember wether the button was enabled

    • verifyButtonEnabled

      protected void verifyButtonEnabled()
      verifyButtonEnabled

    • throwDisabledException

      public void throwDisabledException()
      throw an exception that I'm disbled

    • isDisabled

      public boolean isDisabled()
      Returns true if this button is disabled, meaning that it cannot be clicked.
      Overrides:
      isDisabled in class FormControl

    • doButtonAction

      protected void doButtonAction(int x, int y) throws IOException, SAXException
      Perform the normal action of this button.
      Parameters:
      x - - the x coordinate
      y - - the y coordinate
      Throws:
      IOException
      SAXException

    • doButtonAction

      protected void doButtonAction() throws IOException, SAXException
      Perform the normal action of this button. delegate to the x-y version
      Throws:
      IOException
      SAXException

    • getValues

      protected String[] getValues()
      Description copied from class: FormControl
      Returns the current value(s) associated with this control. These values will be transmitted to the server if the control is 'successful'.
      Specified by:
      getValues in class FormControl

    • addValues

      protected void addValues(com.meterware.httpunit.protocol.ParameterProcessor processor, String characterSet) throws IOException
      Specified by:
      addValues in class FormControl
      Throws:
      IOException

    • newScriptable

      public ScriptableDelegate newScriptable()
      Description copied from class: FormControl
      Creates and returns a scriptable object for this control. Subclasses should override this if they use a different implementation of Scriptable.
      Specified by:
      newScriptable in interface HTMLElement
      Overrides:
      newScriptable in class FormControl

    • getParentDelegate

      public ScriptableDelegate getParentDelegate()
      Description copied from interface: HTMLElement
      Returns the scriptable delegate which can provide the scriptable delegate for this element.
      Specified by:
      getParentDelegate in interface HTMLElement
      Overrides:
      getParentDelegate in class FormControl

    • getID

      public String getID()
      Description copied from interface: HTMLElement
      Returns the ID associated with this element. IDs are unique throughout the HTML document.
      Specified by:
      getID in interface HTMLElement

    • getClassName

      public String getClassName()
      Description copied from interface: HTMLElement
      Returns the class associated with this element.
      Specified by:
      getClassName in interface HTMLElement

    • getTitle

      public String getTitle()
      Description copied from interface: HTMLElement
      Returns the title associated with this element.
      Specified by:
      getTitle in interface HTMLElement

    • getName

      public String getName()
      Description copied from interface: HTMLElement
      Returns the name associated with this element.
      Specified by:
      getName in interface HTMLElement

    • getScriptingHandler

      public ScriptingHandler getScriptingHandler()
      Returns a scriptable object which can act as a proxy for this control.
      Specified by:
      getScriptingHandler in interface HTMLElement

    • doEvent

      public boolean doEvent(String eventScript)
      Deprecated.
      since 1.7 - use doEventScript instead
      handle the event that has the given script attached by compiling the eventScript as a function and executing it
      Specified by:
      doEvent in interface ScriptingEventHandler
      Parameters:
      eventScript - - the script to use
      Returns:
      true if the script is empty or the result of the script

    • doEventScript

      public boolean doEventScript(String eventScript)
      optional do the event if it's defined
      Specified by:
      doEventScript in interface ScriptingEventHandler
      Parameters:
      eventScript -
      Returns:
      true if the script is empty or the result of the script

    • handleEvent

      public boolean handleEvent(String eventName)
      Description copied from interface: ScriptingEventHandler
      handle the event with the given name by getting the attribute and then executing the eventScript for it
      Specified by:
      handleEvent in interface ScriptingEventHandler
      Parameters:
      eventName -
      Returns:
      the result of doEventScript

    • getText

      public String getText()
      Returns the text value of this block.
      Specified by:
      getText in interface HTMLElement

    • getTagName

      public String getTagName()
      Description copied from interface: HTMLElement
      Returns the tag name of this node.
      Specified by:
      getTagName in interface HTMLElement

    • getAttribute

      public String getAttribute(String name)
      get the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      getAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to get
      Returns:
      the attribute

    • setAttribute

      public void setAttribute(String name, Object value)
      set the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      setAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to set
      value - - the value to set

    • removeAttribute

      public void removeAttribute(String name)
      remove the Attribute with the given name - by delegating to NodeUtils
      Specified by:
      removeAttribute in interface HTMLElement
      Parameters:
      name - - the name of the attribute to remove

    • isSupportedAttribute

      public boolean isSupportedAttribute(String name)
      Description copied from interface: HTMLElement
      Returns true if this element may have an attribute with the specified name.
      Specified by:
      isSupportedAttribute in interface HTMLElement

    • getAttribute

      protected String getAttribute(String name, String defaultValue)

    • getNode

      public Node getNode()
      Description copied from interface: HTMLElement
      Returns the DOM node underlying this element.
      Specified by:
      getNode in interface HTMLElement

    • supportAttribute

      protected void supportAttribute(String name)