Package com.iizix.prop.ui
Class KTooltip
- java.lang.Object
- com.iizix.prop.ui.KTooltip
- All Implemented Interfaces:
java.lang.Cloneable
public class KTooltip extends java.lang.Object implements java.lang.Cloneable
KTooltip is the invariant data holder for aTooltipProp
.- Author:
- Christopher Mindus
Field Summary
Fields Modifier and Type Field Description static int
ABOVE
The location: ABOVE (=8).static int
AFTER
The location: AFTER (=6).static int
BEFORE
The location: BEFORE (=4).static int
BELOW
The location: ABOVE (=2).int
category
The message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.static int[]
EMPTY
The "none" locations.int
locations
The locations as an integer that needs packing up usinggetLocations()
, zero for none.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
All Methods Instance Methods Concrete Methods Modifier and Type Method Description KTooltip
clone()
Clones the tooltip.void
dispose()
Disposes of the tooltip when no longer needed.boolean
equals(java.lang.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.java.lang.String
toString()
Creates a string representation for textual output.
Field Detail
ABOVE
public static final int ABOVE
The location: ABOVE (=8).- See Also:
- Constant Field Values
BELOW
public static final int BELOW
The location: ABOVE (=2).- See Also:
- Constant Field Values
BEFORE
public static final int BEFORE
The location: BEFORE (=4).- See Also:
- Constant Field Values
AFTER
public static final int AFTER
The location: AFTER (=6).- See Also:
- Constant Field Values
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 usinggetLocations()
, zero for none.
Constructor Detail
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:
java.lang.NullPointerException
- if text isnull
.
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:
java.lang.NullPointerException
- if text isnull
.
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:
java.lang.NullPointerException
- if text isnull
.
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:
java.lang.NullPointerException
- if text isnull
.
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:
java.lang.NullPointerException
- if text isnull
.
Method Detail
getText
public KString getText()
Gets the text.- Returns:
- The KString text.
clone
public KTooltip clone()
Clones the tooltip.- Overrides:
clone
in classjava.lang.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 java.lang.Throwable
Called when the tooltip is being garbage collected.The KString will be disposed if not previously disposed of.
- Overrides:
finalize
in classjava.lang.Object
- Throws:
java.lang.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(java.lang.Object o)
Checks if two tooltips are equal.- Overrides:
equals
in classjava.lang.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 java.lang.String toString()
Creates a string representation for textual output.- Overrides:
toString
in classjava.lang.Object
- Returns:
- A string formatted for debug output or logging.