Package com.iizix.prop.ui

Class KTooltip

java.lang.Object
com.iizix.prop.ui.KTooltip
All Implemented Interfaces:
Cloneable
public class KTooltip extends Object implements Cloneable
KTooltip is the invariant data holder for a TooltipProp.
Author:
Christopher Mindus

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ABOVE
    The location: ABOVE (=8).
    static final int
    AFTER
    The location: AFTER (=6).
    static final int
    BEFORE
    The location: BEFORE (=4).
    static final int
    BELOW
    The location: ABOVE (=2).
    final int
    category
    The message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.
    static final int[]
    EMPTY
    The "none" locations.
    final int
    locations
    The locations as an integer that needs packing up using getLocations(), zero for none.
    final int
    showDelay
    The show delay in milliseconds, 400 as default, values 0-9999 are allowed.

  • Constructor Summary

    Constructors
    Constructor
    Description
    KTooltip(KString text)
    Creates a tooltip with a default location, category "none" and showDelay 400 ms.
    KTooltip(KString text, int category)
    Creates a tooltip for a message with a default location and showDelay 400 ms.
    KTooltip(KString text, int showDelay, int... locations)
    Creates a tooltip with category "none".
    KTooltip(KString text, int showDelay, int category, int... locations)
    Creates a tooltip for a message.
    KTooltip(KString text, KTooltip prev)
    Creates a tooltip with specified text and settings from another tooltip instance.

  • Method Summary

    Modifier and Type
    Method
    Description
    KTooltip
    clone()
    Clones the tooltip.
    void
    dispose()
    Disposes of the tooltip when no longer needed.
    boolean
    equals(Object o)
    Checks if two tooltips are equal.
    boolean
    equalsOmitReferenceRefreshCheck(KTooltip tooltip)
    Checks for pure equality between two KTooltip's, excluding KString reference refresh counter checking but including potential original source string.
    protected void
    finalize()
    Called when the tooltip is being garbage collected.
    int[]
    getLocations()
    Gets the locations.
    KString
    getText()
    Gets the text.
    String
    toString()
    Creates a string representation for textual output.

    Methods inherited from class java.lang.Object

    getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Field Details

    • ABOVE

      public static final int ABOVE
      The location: ABOVE (=8).
      See Also:

    • BELOW

      public static final int BELOW
      The location: ABOVE (=2).
      See Also:

    • BEFORE

      public static final int BEFORE
      The location: BEFORE (=4).
      See Also:

    • AFTER

      public static final int AFTER
      The location: AFTER (=6).
      See Also:

    • EMPTY

      public static final int[] EMPTY
      The "none" locations.

    • category

      public final int category
      The message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.

    • showDelay

      public final int showDelay
      The show delay in milliseconds, 400 as default, values 0-9999 are allowed.

    • locations

      public final int locations
      The locations as an integer that needs packing up using getLocations(), zero for none.

  • Constructor Details

    • KTooltip

      public KTooltip(KString text)
      Creates a tooltip with a default location, category "none" and showDelay 400 ms.
      Parameters:
      text - The KString text for the tooltip.
      Throws:
      NullPointerException - if text is null.

    • KTooltip

      public KTooltip(KString text, KTooltip prev)
      Creates a tooltip with specified text and settings from another tooltip instance.
      Parameters:
      text - The KString text for the tooltip.
      prev - The previous instance for settings.
      Throws:
      NullPointerException - if text is null.

    • KTooltip

      public KTooltip(KString text, int showDelay, int... locations)
      Creates a tooltip with category "none".
      Parameters:
      text - The KString text for the tooltip.
      showDelay - The show delay in milliseconds (0-9999, -1 for default 400 ms).
      locations - List of locations in priority order, max 4.
      Throws:
      NullPointerException - if text is null.

    • KTooltip

      public KTooltip(KString text, int category)
      Creates a tooltip for a message with a default location and showDelay 400 ms.
      Parameters:
      text - The KString text for the tooltip.
      category - The message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.
      Throws:
      NullPointerException - if text is null.

    • KTooltip

      public KTooltip(KString text, int showDelay, int category, int... locations)
      Creates a tooltip for a message.
      Parameters:
      text - The KString text for the tooltip.
      showDelay - The show delay in milliseconds (0-9999).
      category - The message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.
      locations - List of locations in priority order, max 4.
      Throws:
      NullPointerException - if text is null.

  • Method Details

    • getText

      public KString getText()
      Gets the text.
      Returns:
      The KString text.

    • clone

      public KTooltip clone()
      Clones the tooltip.
      Overrides:
      clone in class Object
      Returns:
      A cloned tooltip.

    • dispose

      public void dispose()
      Disposes of the tooltip when no longer needed. This method is required for KString text.

    • finalize

      protected void finalize() throws Throwable
      Called when the tooltip is being garbage collected.

      The KString will be disposed if not previously disposed of.

      Overrides:
      finalize in class Object
      Throws:
      Throwable

    • getLocations

      public int[] getLocations()
      Gets the locations.
      Returns:
      A location list of integers, maximum 4 with values 2, 4, 6 or 8 in order of importance.

    • equals

      public boolean equals(Object o)
      Checks if two tooltips are equal.
      Overrides:
      equals in class Object

    • equalsOmitReferenceRefreshCheck

      public boolean equalsOmitReferenceRefreshCheck(KTooltip tooltip)
      Checks for pure equality between two KTooltip's, excluding KString reference refresh counter checking but including potential original source string.

      This method is used when comparing values for e.g. save file.

      Parameters:
      tooltip - Another KTooltip, perhaps null.
      Returns:
      true if equal, false otherwise.

    • toString

      public String toString()
      Creates a string representation for textual output.
      Overrides:
      toString in class Object
      Returns:
      A string formatted for debug output or logging.