Package com.iizix.swt

Class SWTHelper

  • public class SWTHelper
extends java.lang.Object
    Some SWT helpers.
    Author:
    Christopher Mindus

    • Constructor Summary

      Constructors 
      ConstructorDescription
      SWTHelper() 

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and TypeMethodDescription
      static voidaddCapsLockWarning​(org.eclipse.swt.widgets.Text passwordField)
      Adds a caps-lock warning decorator to a password field.
      static org.eclipse.swt.custom.TableEditoraddEditableTableColumn​(org.eclipse.swt.widgets.Table table, int column, int minimumWidth, org.eclipse.swt.events.ModifyListener modifyListener)
      Adds an editable column for a table.
      static voidaddMenuSeparator​(org.eclipse.swt.widgets.Menu menu)
      Adds a menu separator.
      static voidaddTableColumnResizer​(org.eclipse.swt.widgets.Table table)
      Adds a table column re-sizer to make the last column resize with the table and dialog box.
      static voidaddTableSorter​(org.eclipse.swt.widgets.Table table, java.lang.String... dataKeys)
      Adds a table sorter.
      static voidaddTreeColumnResizer​(org.eclipse.swt.widgets.Tree tree)
      Adds a table column re-sizer to make the last column resize with the table and dialog box.
      static org.eclipse.swt.browser.BrowsercreateBrowser​(org.eclipse.swt.widgets.Composite parent)
      Creates a Browser instance that uses Edge under Windows if Eclipse is of version 4.19 or better and Edge is installed, or attempts to create a Chromium instance for non-macOS operating systems.
      static org.eclipse.swt.graphics.ImagecreateImage​(int rgb, int width, int height)
      Create an image of a color.
      static org.eclipse.swt.graphics.ImagecreateImage​(int rgb, int width, int height, boolean doFrame)
      Create an image of a color.
      static org.eclipse.swt.graphics.ImagecreateImage​(int r, int g, int b, int width, int height)
      Create an image of a color.
      static org.eclipse.swt.graphics.ImagecreateImage​(int r, int g, int b, int width, int height, boolean doFrame)
      Create an image of a color.
      static org.eclipse.swt.graphics.ImagecreateImage​(org.eclipse.swt.graphics.Color color, int width, int height)
      Create an image of the specified color.
      static org.eclipse.swt.graphics.ImagecreateImage​(org.eclipse.swt.graphics.Color color, int width, int height, boolean doFrame)
      Create an image of the specified color.
      static voidenableDialogMove​(org.eclipse.swt.widgets.Shell shell)
      Enables move of a dialog box.
      static voidexpandAll​(org.eclipse.jface.viewers.TreeViewer viewer)
      Performs the Expand all on a tree viewer, very fast.
      static voidfixComboMWScroll​(org.eclipse.swt.widgets.Control combo)
      Fix for Combobox processing mouse wheel when not focused in Win32, eating mouse from scroll pane.
      static org.osgi.framework.VersiongetEclipseVersion()
      Attempts to get the version of the Eclipse IDE we're running in.
      static intgetEditedTableLine()
      Gets the edited line number of a Table Editor.
      static org.eclipse.swt.widgets.TextgetEditedTableText()
      Gets the entry field being edited, null for none.
      static org.eclipse.swt.widgets.ControlgetFocusControl​(org.eclipse.swt.widgets.Composite composite)
      Gets the control in focus for a composite.
      static voidresizeColumns​(org.eclipse.swt.widgets.Table table)
      Packs the tables columns and resizes the last column in a table to fit the table width.
      static voidresizeColumns​(org.eclipse.swt.widgets.Tree tree)
      Packs the tree table columns and resizes the last column in a table to fit the table width.
      static voidsetEnabledRecursive​(org.eclipse.swt.widgets.Control control, boolean isEnabled)
      Enables or disables a control/composite and all its children.
      static voidshowPopupMenu​(IzMenu menu)
      Displays a drop-down menu at screen location where mouse is located.
      static voidshowPopupMenu​(IzMenu menu, int x, int y)
      Displays a drop-down menu at screen location.
      static voidshowPopupMenu​(IzMenu menu, org.eclipse.swt.widgets.Control control)
      Displays a drop-down menu below a control.
      static voidshowPopupMenu​(IzMenu menu, org.eclipse.swt.widgets.Control control, int xOffset, int yOffset)
      Displays a drop-down menu below a control.
      static voidshowPopupMenu​(IzMenu menu, org.eclipse.swt.widgets.ToolItem item)
      Displays a drop-down menu below a control.
      static voidshowPopupMenu​(org.eclipse.swt.widgets.Menu menu)
      Displays a drop-down menu at screen location where mouse is located.
      static voidshowPopupMenu​(org.eclipse.swt.widgets.Menu menu, int x, int y)
      Displays a drop-down menu at screen location.
      static voidshowPopupMenu​(org.eclipse.swt.widgets.Menu menu, org.eclipse.swt.widgets.Control control)
      Displays a drop-down menu below a control.
      static voidshowPopupMenu​(org.eclipse.swt.widgets.Menu menu, org.eclipse.swt.widgets.Control control, int xOffset, int yOffset)
      Displays a drop-down menu below a control.
      static voidshowPopupMenu​(org.eclipse.swt.widgets.Menu menu, org.eclipse.swt.widgets.ToolItem item)
      Displays a drop-down menu below a control.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • SWTHelper

        public SWTHelper()

    • Method Detail

      • resizeColumns

        public static void resizeColumns​(org.eclipse.swt.widgets.Table table)
        Packs the tables columns and resizes the last column in a table to fit the table width.
        Parameters:
        table - The table to resize the last column.

      • resizeColumns

        public static void resizeColumns​(org.eclipse.swt.widgets.Tree tree)
        Packs the tree table columns and resizes the last column in a table to fit the table width.
        Parameters:
        tree - The tree table to resize the last column.

      • addTableColumnResizer

        public static void addTableColumnResizer​(org.eclipse.swt.widgets.Table table)
        Adds a table column re-sizer to make the last column resize with the table and dialog box.
        Parameters:
        table - The table to resize the last column.

      • addTreeColumnResizer

        public static void addTreeColumnResizer​(org.eclipse.swt.widgets.Tree tree)
        Adds a table column re-sizer to make the last column resize with the table and dialog box.
        Parameters:
        tree - The tree to resize the last column.

      • addTableSorter

        public static void addTableSorter​(org.eclipse.swt.widgets.Table table,
                                  java.lang.String... dataKeys)
        Adds a table sorter.

      • addEditableTableColumn

        public static org.eclipse.swt.custom.TableEditor addEditableTableColumn​(org.eclipse.swt.widgets.Table table,
                                                                        int column,
                                                                        int minimumWidth,
                                                                        org.eclipse.swt.events.ModifyListener modifyListener)
        Adds an editable column for a table.
        Parameters:
        table - The table.
        column - The column index.
        minimumWidth - The minimum pixel width of the Text editor (for layout).
        modifyListener - Possible listener for entry field Text modifications.
        Returns:
        The table editor created.

      • getEditedTableLine

        public static int getEditedTableLine()
        Gets the edited line number of a Table Editor.

      • getEditedTableText

        public static org.eclipse.swt.widgets.Text getEditedTableText()
        Gets the entry field being edited, null for none.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(int rgb,
                                                         int width,
                                                         int height)
        Create an image of a color.
        Parameters:
        rgb - RGB value color.
        width - Width of image.
        height - Height of image.
        Returns:
        The image filled with the color.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(int rgb,
                                                         int width,
                                                         int height,
                                                         boolean doFrame)
        Create an image of a color.
        Parameters:
        rgb - RGB value color.
        width - Width of image.
        height - Height of image.
        doFrame - If the image should be framed.
        Returns:
        The image filled with the color.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(int r,
                                                         int g,
                                                         int b,
                                                         int width,
                                                         int height)
        Create an image of a color.
        Parameters:
        r - Red color of image (0-255).
        g - Green color of image (0-255).
        b - Blue color of image (0-255).
        width - Width of image.
        height - Height of image.
        Returns:
        The image filled with the color.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(int r,
                                                         int g,
                                                         int b,
                                                         int width,
                                                         int height,
                                                         boolean doFrame)
        Create an image of a color.
        Parameters:
        r - Red color of image (0-255).
        g - Green color of image (0-255).
        b - Blue color of image (0-255).
        width - Width of image.
        height - Height of image.
        doFrame - If the image should be framed.
        Returns:
        The image filled with the color.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(org.eclipse.swt.graphics.Color color,
                                                         int width,
                                                         int height)
        Create an image of the specified color.
        Parameters:
        color - Color of image.
        width - Width of image.
        height - Height of image.
        Returns:
        The image filled with the color.

      • createImage

        public static org.eclipse.swt.graphics.Image createImage​(org.eclipse.swt.graphics.Color color,
                                                         int width,
                                                         int height,
                                                         boolean doFrame)
        Create an image of the specified color.
        Parameters:
        color - Color of image.
        width - Width of image.
        height - Height of image.
        doFrame - If the image should be framed.
        Returns:
        The image filled with the color.

      • showPopupMenu

        public static void showPopupMenu​(org.eclipse.swt.widgets.Menu menu,
                                 org.eclipse.swt.widgets.ToolItem item)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(IzMenu menu,
                                 org.eclipse.swt.widgets.ToolItem item)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(org.eclipse.swt.widgets.Menu menu,
                                 org.eclipse.swt.widgets.Control control)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(IzMenu menu,
                                 org.eclipse.swt.widgets.Control control)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(org.eclipse.swt.widgets.Menu menu,
                                 org.eclipse.swt.widgets.Control control,
                                 int xOffset,
                                 int yOffset)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(IzMenu menu,
                                 org.eclipse.swt.widgets.Control control,
                                 int xOffset,
                                 int yOffset)
        Displays a drop-down menu below a control.

      • showPopupMenu

        public static void showPopupMenu​(org.eclipse.swt.widgets.Menu menu,
                                 int x,
                                 int y)
        Displays a drop-down menu at screen location.

      • showPopupMenu

        public static void showPopupMenu​(IzMenu menu,
                                 int x,
                                 int y)
        Displays a drop-down menu at screen location.

      • showPopupMenu

        public static void showPopupMenu​(org.eclipse.swt.widgets.Menu menu)
        Displays a drop-down menu at screen location where mouse is located.

      • showPopupMenu

        public static void showPopupMenu​(IzMenu menu)
        Displays a drop-down menu at screen location where mouse is located.

      • expandAll

        public static void expandAll​(org.eclipse.jface.viewers.TreeViewer viewer)
        Performs the Expand all on a tree viewer, very fast.

      • getFocusControl

        public static org.eclipse.swt.widgets.Control getFocusControl​(org.eclipse.swt.widgets.Composite composite)
        Gets the control in focus for a composite.
        Returns:
        The control having focus in the composite, of null for none.

      • fixComboMWScroll

        public static void fixComboMWScroll​(org.eclipse.swt.widgets.Control combo)
        Fix for Combobox processing mouse wheel when not focused in Win32, eating mouse from scroll pane.

      • setEnabledRecursive

        public static void setEnabledRecursive​(org.eclipse.swt.widgets.Control control,
                                       boolean isEnabled)
        Enables or disables a control/composite and all its children.
        Parameters:
        control - The control or composite.
        isEnabled - Enabled flag.

      • addMenuSeparator

        public static void addMenuSeparator​(org.eclipse.swt.widgets.Menu menu)
        Adds a menu separator.
        Parameters:
        menu - The menu.

      • enableDialogMove

        public static void enableDialogMove​(org.eclipse.swt.widgets.Shell shell)
        Enables move of a dialog box.
        Parameters:
        shell - The shell that should be movable.

      • addCapsLockWarning

        public static void addCapsLockWarning​(org.eclipse.swt.widgets.Text passwordField)
        Adds a caps-lock warning decorator to a password field. If you call this method multiple times for the same password field, nothing will happen (except for the first time).
        Parameters:
        passwordField - The password field.

      • getEclipseVersion

        public static org.osgi.framework.Version getEclipseVersion()
        Attempts to get the version of the Eclipse IDE we're running in.
        Returns:
        The version, or null if it couldn't be detected.

      • createBrowser

        public static org.eclipse.swt.browser.Browser createBrowser​(org.eclipse.swt.widgets.Composite parent)
        Creates a Browser instance that uses Edge under Windows if Eclipse is of version 4.19 or better and Edge is installed, or attempts to create a Chromium instance for non-macOS operating systems.
        Parameters:
        parent - The parent composite.
        Returns:
        The browser instance.