Package org.fife.ui.rtextarea

Class IconGroup

  • public class IconGroup
extends Object
    This class encapsulates the location, properties, etc. of an icon set used for an instance of RTextArea. If the location of the icon group is invalid in any way, any attempt to retrieve icons from an icon group will return null.

    • Constructor Detail

      • IconGroup

        public IconGroup​(String name,
                 String path)
        Creates an icon set without "large versions" of the icons.
        Parameters:
        name - The name of the icon group.
        path - The directory containing the icon group.

      • IconGroup

        public IconGroup​(String name,
                 String path,
                 String largeIconSubDir)
        Constructor.
        Parameters:
        name - The name of the icon group.
        path - The directory containing the icon group.
        largeIconSubDir - The subdirectory containing "large versions" of the icons. If no subdirectory exists, pass in null.

      • IconGroup

        public IconGroup​(String name,
                 String path,
                 String largeIconSubDir,
                 String extension)
        Constructor.
        Parameters:
        name - The name of the icon group.
        path - The directory containing the icon group.
        largeIconSubDir - The subdirectory containing "large versions" of the icons. If no subdirectory exists, pass in null.
        extension - The extension of the icons (one of gif, jpg, or png).

      • IconGroup

        public IconGroup​(String name,
                 String path,
                 String largeIconSubDir,
                 String extension,
                 String jar)
        Constructor.
        Parameters:
        name - The name of the icon group.
        path - The directory containing the icon group.
        largeIconSubDir - The subdirectory containing "large versions" of the icons. If no subdirectory exists, pass in null.
        extension - The extension of the icons (one of gif, jpg, or png).
        jar - The Jar file containing the icons, or null if the icons are on the local file system. If a Jar is specified, the value of path must be a path in the Jar file. If this is not a valid Jar file, then no Jar file will be used, meaning all icons returned from this icon group will be null.

    • Method Detail

      • equals

        public boolean equals​(Object o2)
        Returns whether two icon groups are equal.
        Overrides:
        equals in class Object
        Parameters:
        o2 - The object to check against.
        Returns:
        Whether o2 represents the same icons as this icon group.

      • getIcon

        public Icon getIcon​(String name)
        Returns the icon from this icon group with the specified name.
        Parameters:
        name - The name of the icon. For example, if you want the icon specified in new.gif, this value should be new.
        Returns:
        The icon, or null if it could not be found or loaded.
        See Also:
        getLargeIcon(java.lang.String)

      • getLargeIcon

        public Icon getLargeIcon​(String name)
        Returns the large icon from this icon group with the specified name. If this icon group does not have large icons, null is returned.
        Parameters:
        name - The name of the icon. For example, if you want the icon specified in new.gif, this value should be new.
        Returns:
        The icon, or null if it could not be found or loaded.
        See Also:
        getLargeIcon(java.lang.String)

      • getName

        public String getName()
        Returns the name of this icon group.
        Returns:
        This icon group's name.

      • hasSeparateLargeIcons

        public boolean hasSeparateLargeIcons()
        Returns whether a separate directory for the large icons exists.
        Returns:
        Whether a directory containing "large versions" ov the icons exists.
        See Also:
        getLargeIcon(String)

      • hashCode

        public int hashCode()
        Overridden since we also override equals(Object), to honor the invariant that equal objects must have equal hashcodes. This also keeps FindBugs happy.
        Overrides:
        hashCode in class Object