Package com.portal.pfc.ui

Class BigIntegerTextField

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JTextField
com.portal.pfc.ui.ValidatedTextField
com.portal.pfc.ui.BigIntegerTextField
All Implemented Interfaces:
CyclerListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, Scrollable, SwingConstants
Direct Known Subclasses:
PIABigIntegerField
public class BigIntegerTextField extends ValidatedTextField
A textfield that accepts numeric data only. Decimal/fractional input is rejected - the number represented by this textfield must be an integer.
See Also:

  • Constructor Details

    • BigIntegerTextField

      public BigIntegerTextField()
      Constructs a new BigIntegerTextField. The number of columns is set to 10. The default minimum value allowed (when in a SpinnerField) is 0, and the maximum value is 100.

    • BigIntegerTextField

      public BigIntegerTextField(int cols)
      Constructs a new BigIntegerTextField containing the specified number of columns. The default minimum value allowed (when in a SpinnerField) is 0, and the maximum value is 100.
      Parameters:
      columns - the number of columns to use to calculate the preferred width.

  • Method Details

    • setText

      public void setText(String str)
      Sets the text of this textfield to the specified text, granted the specified text contains numeric data only. If the specified text contains alphabetic characters (including the currency symbol and/or the grouping separator) the text is rejected.
      Overrides:
      setText in class JTextComponent
      Parameters:
      str - the new text to display

    • coalesceEvents

      public boolean coalesceEvents()

    • replaceSelection

      public void replaceSelection(String str)
      Replaces the currently selected content with the specified text, granted the specified text contains numeric data only. If the specified text contains alphabetic characters the text is rejected. If there is no selection this amounts to an insert of the specified text.
      Overrides:
      replaceSelection in class JTextComponent
      Parameters:
      str - the text to use when replacing the selected text

    • getValue

      public Object getValue()
      Used to retrieve the value of component as an Integer instead of a String (using getText()). Note that you may get a NumberFormatException if the number represented in the textfield exceeds the maximum Integer value. If that is the case, you may choose to retrieve the number as a String instead.
      Specified by:
      getValue in class ValidatedTextField
      Returns:
      the numeric value of the component

    • valueChange

      public void valueChange(CyclerEvent e)
      Called when this component is embedded in a SpinnerField and the associated Cycler is selected.
      Specified by:
      valueChange in interface CyclerListener
      Specified by:
      valueChange in class ValidatedTextField
      Parameters:
      e - the CyclerEvent

    • setMaximumValue

      public void setMaximumValue(int max)
      Sets the minimum value allowed
      Parameters:
      max - the max value

    • setMaximumValue

      public void setMaximumValue(long max)

    • setMaximumValue

      public void setMaximumValue(String max)

    • getMaximumValue

      public long getMaximumValue()
      Gets the maximum value allowed
      Returns:
      the max value

    • setMinimumValue

      public void setMinimumValue(int min)
      Sets the minimum value allowed
      Parameters:
      the - minimum value

    • setMinimumValue

      public void setMinimumValue(long min)

    • setMinimumValue

      public void setMinimumValue(String min)

    • getMinimumValue

      public long getMinimumValue()
      Gets the minimum value allowed when spinning up.
      Returns:
      the min value

    • setAllowEmptyValue

      public void setAllowEmptyValue(boolean b)
      If true, the textfield appears initially empty and getText() will return an empty string. Otherwise, the textfield will have an initial value of the minimum value.
      This is initially false;
      Parameters:
      b - Determines the state

    • isAllowEmptyValue

      public boolean isAllowEmptyValue()
      Reports whether the textfield can have an empty value.
      Returns:
      true if the textfield can have an empty value; false otherwise.

    • setNumDigitsAllowed

      public void setNumDigitsAllowed(int len)
      Establishes the maximum number of digits allowed in this textfield Note that if the resulting number exceeds the maximum value of an Integer you will not be able to retrieve the value as an Integer.
      The default is 10.
      Parameters:
      len -

    • getNumDigitsAllowed

      public int getNumDigitsAllowed()

    • addNotify

      public void addNotify()
      Overrides:
      addNotify in class JComponent