Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.gwtext.client.widgets
Class ProgressBar

    java.lang.Object
      com.google.gwt.user.client.ui.UIObject
          com.google.gwt.user.client.ui.Widget
              com.gwtext.client.widgets.Component
                  com.gwtext.client.widgets.BoxComponent
                      com.gwtext.client.widgets.ProgressBar

All Implemented Interfaces:
  com.google.gwt.user.client.EventListener, Observable

    public class ProgressBar

extends BoxComponent

An updateable progress bar component. The progress bar supports two different modes: manual and automatic.
In manual mode, you are responsible for showing, updating (via updateProgress) and clearing the progress bar as needed from your own code. This method is most appropriate when you want to show progress throughout an operation that has predictable points of interest at which you can update the control.
In automatic mode, you simply call wait and let the progress bar run indefinitely, only clearing it once the operation is complete. You can optionally have the progress bar wait for a specific amount of time and then clear itself. Automatic mode is most appropriate for timed operations or asymchronous operations in which you have no need for indicating intermediate progress.

Field Summary

Fields inherited from class com.gwtext.client.widgets.Component
`config, id`

Constructor Summary
`ProgressBar()`
`ProgressBar(com.google.gwt.core.client.JavaScriptObject jsObj)`

Method Summary
`void` | `addListener(ProgressBarListener listener)` Add a ProgressBar listener.
`protected com.google.gwt.core.client.JavaScriptObject` | `create(com.google.gwt.core.client.JavaScriptObject config)`
`protected com.google.gwt.core.client.JavaScriptObject` | `getConfigPrototype()`
`java.lang.String` | `getText()` The progress bar text.
`float` | `getValue()`
`java.lang.String` | `getXType()` Gets the xtype for this component as registered with ComponentMgr.
`boolean` | `isWaiting()` Returns true if the progress bar is currently in a `wait(com.gwtext.client.widgets.WaitConfig)` operation.
`void` | `reset()` Resets the progress bar value to 0 and text to empty string.
`void` | `reset(boolean hide)` Resets the progress bar value to 0 and text to empty string.
`void` | `setSize(int width, int height)` Sets the size of the progress bar.
`void` | `setText(java.lang.String text)` The progress bar text (defaults to '').
`void` | `setTextEl(com.google.gwt.user.client.Element textEl)` The element to render the progress text to (defaults to the progress bar's internal text element).
`void` | `setTextEl(java.lang.String textElID)` The element to render the progress text to (defaults to the progress bar's internal text element).
`void` | `setValue(float value)` The value of the progress bar.
`void` | `updateProgress(float value)` Updates the progress bar value.
`void` | `updateProgress(float value, java.lang.String text)` Updates the progress bar value, and its text.
`void` | `updateText(java.lang.String text)` Updates the progress bar text.
`void` | `wait(WaitConfig waitConfig)` Initiates an auto-updating progress bar.

Methods inherited from class com.gwtext.client.widgets.BoxComponent
`addListener, doOnRender, doOnRender, getAutoHeight, getAutoWidth, getBox, getBox, getHeight, getPosition, getPosition, getSize, getWidth, setAutoHeight, setAutoWidth, setHeight, setHeight, setPagePosition, setPosition, setWidth, setWidth, syncSize, updateBox`

Methods inherited from class com.gwtext.client.widgets.Component
`addClass, addClassCreated, addEvent, addEvents, addListener, addListener, addListener, afterRender, beforeDestroy, check, cloneComponent, cloneComponent, cloneConfig, destroy, disable, enable, equals, error, focus, focus, focus, getApplyTo, getAttribute, getAttributeAsBoolean, getAttributeAsFloat, getAttributeAsInt, getAttributeAsJavaScriptObject, getAutoShow, getCls, getComponentJS, getConfig, getCtCls, getDisabledClass, getEl, getElement, getElement, getHideMode, getHideParent, getId, getItemId, getJsObj, getOffsetHeight, getOffsetWidth, getOrCreateJsObj, getOwnerContainer, getRenderTo, getStateEvents, getStateId, getStyle, getStyleElement, getTitle, getXTypes, hashCode, hide, initComponent, isCreated, isDisabled, isHidden, isRendered, isVisible, isXType, isXType, onDestroy, removeClass, render, render, render, render, render, render, setApplyTo, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAttribute, setAutoEl, setAutoShow, setCls, setCtCls, setDisabled, setDisabledClass, setEl, setEl, setHideMode, setHideParent, setId, setRenderTo, setStateEvents, setStateId, setStyle, setTitle, setVisible, show`

Methods inherited from class com.google.gwt.user.client.ui.Widget
`doAttachChildren, doDetachChildren, getParent, isAttached, onAttach, onBrowserEvent, onDetach, onLoad, onUnload, removeFromParent, setElement`

Methods inherited from class com.google.gwt.user.client.ui.UIObject
`addStyleDependentName, addStyleName, getAbsoluteLeft, getAbsoluteTop, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, isVisible, removeStyleDependentName, removeStyleName, setPixelSize, setSize, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setVisible, sinkEvents, toString, unsinkEvents`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### ProgressBar

    public ProgressBar()

### ProgressBar

    public ProgressBar(com.google.gwt.core.client.JavaScriptObject jsObj)

Method Detail

### getConfigPrototype

    protected com.google.gwt.core.client.JavaScriptObject getConfigPrototype()

  Overrides:
    `getConfigPrototype` in class `BoxComponent`

### getXType

    public java.lang.String getXType()

  Description copied from class: `Component`
  Gets the xtype for this component as registered with ComponentMgr. For a list of all available xtypes, see the Component javadocs.

       TextField field = new TextField();
       field.getXType() returns "textfield"

  Overrides:
    `getXType` in class `BoxComponent`
  Returns:
    the xtype

### create

    protected com.google.gwt.core.client.JavaScriptObject create(com.google.gwt.core.client.JavaScriptObject config)

  Overrides:
    `create` in class `BoxComponent`

### isWaiting

    public boolean isWaiting()

  Returns true if the progress bar is currently in a `wait(com.gwtext.client.widgets.WaitConfig)` operation.

  Returns:
    true if in wait

### reset

    public void reset()

  Resets the progress bar value to 0 and text to empty string.

### reset

    public void reset(boolean hide)

  Resets the progress bar value to 0 and text to empty string. If hide = true, the progress bar will also be hidden (using the hideMode property internally).

  Parameters:
    `hide` - true to hide the progress bar (defaults to false)

### setSize

    public void setSize(int width,
                        int height)

  Sets the size of the progress bar.

  Parameters:
    `width` - the width
    `height` - the height

### updateProgress

    public void updateProgress(float value)

  Updates the progress bar value. Any existing text value will be unchanged. Note that even if the progress bar value exceeds 1, it will never automatically reset -- you are responsible for determining when the progress is complete and calling reset to clear and/or hide the control.

  Parameters:
    `value` - the new value

### updateProgress

    public void updateProgress(float value,
                               java.lang.String text)

  Updates the progress bar value, and its text. Note that even if the progress bar value exceeds 1, it will never automatically reset -- you are responsible for determining when the progress is complete and calling reset to clear and/or hide the control.

  Parameters:
    `value` - the new value
    `text` - the new text

### updateText

    public void updateText(java.lang.String text)

  Updates the progress bar text. If specified, textEl will be updated, otherwise the progress bar itself will display the updated text.

  Parameters:
    `text` - the text to display

### wait

    public void wait(WaitConfig waitConfig)

  Initiates an auto-updating progress bar. A duration can be specified, in which case the progress bar will automatically reset after a fixed amount of time and optionally call a callback function if specified. If no duration is passed in, then the progress bar will run indefinitely and must be manually cleared by calling reset.

  Parameters:
    `waitConfig` - the wait configuration

### addListener

    public void addListener(ProgressBarListener listener)

  Add a ProgressBar listener.

  Parameters:
    `listener` - the listener

### setText

    public void setText(java.lang.String text)

  The progress bar text (defaults to '').

  Parameters:
    `text` - the progress bar text

### getText

    public java.lang.String getText()

  The progress bar text.

  Returns:
    the progress bar text (defaults to '')

### setTextEl

    public void setTextEl(java.lang.String textElID)
                   throws java.lang.IllegalStateException

  The element to render the progress text to (defaults to the progress bar's internal text element).
  Note that the text element must already be rendered to the DOM before creation of the progress bar. You can call textElComponent.render(RootPanel.getBodyElement()) to force addition of the textEl to the broswer DOM.

  Parameters:
    `textElID` - the text element ID
  Throws:
    `java.lang.IllegalStateException` - this property cannot be changed after the Component has been rendered

### setTextEl

    public void setTextEl(com.google.gwt.user.client.Element textEl)
                   throws java.lang.IllegalStateException

  The element to render the progress text to (defaults to the progress bar's internal text element).
  Note that the text element must already be rendered to the DOM before creation of the progress bar. You can call textElComponent.render(RootPanel.getBodyElement()) to force addition of the textEl to the broswer DOM.

  Parameters:
    `textEl` - the text element
  Throws:
    `java.lang.IllegalStateException` - this property cannot be changed after the Component has been rendered

### setValue

    public void setValue(float value)

  The value of the progress bar. A floating point value between 0 and 1 (e.g., .5, defaults to 0)

  Parameters:
    `value` - the value of the progress bar

### getValue

    public float getValue()

  Returns:
    the value of the progress bar

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD