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.CloneableKTooltip is the invariant data holder for a- TooltipProp.- Author:
- Christopher Mindus
 
- Field Summary- Fields - Modifier and Type - Field - Description - static int- ABOVEThe location: ABOVE (=8).- static int- AFTERThe location: AFTER (=6).- static int- BEFOREThe location: BEFORE (=4).- static int- BELOWThe location: ABOVE (=2).- int- categoryThe message category if this applies, -1 for none, 0=informational, 1=warning, 2=error.- static int[]- EMPTYThe "none" locations.- int- locationsThe locations as an integer that needs packing up using- getLocations(), zero for none.- int- showDelayThe 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 using- getLocations(), 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 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:
- java.lang.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:
- java.lang.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:
- java.lang.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:
- java.lang.NullPointerException- if text is- null.
 
 
 - Method Detail- getText- public KString getText() Gets the text.- Returns:
- The KString text.
 
 - clone- public KTooltip clone() Clones the tooltip.- Overrides:
- clonein class- java.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.ThrowableCalled when the tooltip is being garbage collected.- The KString will be disposed if not previously disposed of. - Overrides:
- finalizein class- java.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:
- equalsin class- java.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:
- toStringin class- java.lang.Object
- Returns:
- A string formatted for debug output or logging.