ch.elexis.util
Class SWTHelper

java.lang.Object
  ch.elexis.util.SWTHelper

public class SWTHelper
extends java.lang.Object

statische Hilfsfunktionen für SWT-Objekte

Nested Class Summary

static interface	SWTHelper.IControlProvider
static class	SWTHelper.SimpleDialog

Constructor Summary

SWTHelper()

Method Summary

static void	addSeparator(org.eclipse.swt.widgets.Composite parent) Convenience method to add a separator bar to the composite.
static void	alert(java.lang.String title, java.lang.String message) Eine Alertbox anzeigen (synchron)
static boolean	askYesNo(java.lang.String title, java.lang.String message) Eine mit Ja oder Nein zu beantwortende Frage im UI-Thread zeigen
static java.lang.Boolean	askYesNoCancel(java.lang.String title, java.lang.String message) Eine mit Ja, Nein oder Abbrechen zu beantwortende Frage im UI-Thread zeigen
static boolean	blameEmptyString(java.lang.String test, java.lang.String name) Check whether the String is empty and give an error message if so
static void	center(org.eclipse.swt.widgets.Shell child) Ein Objekt auf dem Bildschirm zentrieren.
static void	center(org.eclipse.swt.widgets.Shell parent, org.eclipse.swt.widgets.Composite child) Ein Objekt innerhalb des parents zentrieren
static void	center(org.eclipse.swt.widgets.Shell parent, org.eclipse.swt.widgets.Shell child) Ein Objekt innerhalb des parents zentrieren
static java.awt.Font	createAWTFontFromSWTFont(org.eclipse.swt.graphics.Font swtFont)
static org.eclipse.swt.widgets.Label	createHyperlink(org.eclipse.swt.widgets.Composite parent, java.lang.String text, org.eclipse.ui.forms.events.IHyperlinkListener lis) Return a Label that acts as a hyperlink
static LabeledInputField	createLabeledField(org.eclipse.swt.widgets.Composite parent, java.lang.String label, LabeledInputField.Typ typ)
static org.eclipse.ui.forms.widgets.TableWrapLayout	createTableWrapLayout(int numColumns, boolean makeColumnsEqualWidth) Constructor wrapper for TableWrapLayout, so that parameters are identical to GridLayout(numColumns, makeColumnsEqualWidth)
static org.eclipse.swt.widgets.Text	createText(org.eclipse.swt.widgets.Composite parent, int lines, int flags) Create a multiline text widget with a specified height in lines (calculated with the Text's default font)
static org.eclipse.swt.widgets.Text	createText(org.eclipse.ui.forms.widgets.FormToolkit tk, org.eclipse.swt.widgets.Composite parent, int lines, int flags)
static org.eclipse.swt.layout.GridData	fillGrid(org.eclipse.swt.widgets.Composite parent, int cols)
static org.eclipse.swt.graphics.Color	getContrast(org.eclipse.swt.graphics.Color col) Return a color that contrasts optimally to the given color
static org.eclipse.swt.layout.GridData	getFillGridData() Shortcut for getFillGridData(1,true,1,true);
static org.eclipse.swt.layout.GridData	getFillGridData(int hSpan, boolean hFill, int vSpan, boolean vFill) Ein GridData-Objekt erzeugen, das den horizontalen und/oder vertikalen Freiraum ausfüllt.
static org.eclipse.ui.forms.widgets.TableWrapData	getFillTableWrapData(int hSpan, boolean hFill, int vSpan, boolean vFill) Ein TableWrapDAta-Objekt erzeugen, das den horizontalen und/oder vertikalen Freiraum ausfüllt.
static org.eclipse.swt.graphics.Point	getStringBounds(org.eclipse.swt.widgets.Composite c, java.lang.String s)
static void	reloadViewPart(java.lang.String viewID) This method "reloads" a view, by closing and opening it.
static org.eclipse.swt.layout.GridData	setGridDataHeight(org.eclipse.swt.widgets.Control control, int lines, boolean fillHorizontal) Set a GridData to the given Control that sets the specified height in lines calculated with the control's current font.
static void	setSelectOnFocus(org.eclipse.swt.widgets.Text text) Adds a FocusListener to text so that the text is selected as soon as the control gets the focus.
static void	showError(java.lang.String title, java.lang.String message) Eine Standard-Fehlermeldung asynchron im UI-Thread zeigen
static void	showError(java.lang.String logHeader, java.lang.String title, java.lang.String message) Eine Standard-Fehlermeldung asynchron zeigen und loggen
static void	showInfo(java.lang.String title, java.lang.String message) Eine Standard-Infomeldung asynchron zeigen
static int	size(org.eclipse.swt.graphics.Rectangle r)
static void	writeCentered(org.eclipse.swt.graphics.GC gc, java.lang.String text, org.eclipse.swt.graphics.Rectangle bounds) Einen Text zentriert in ein Rechteck schreiben

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

center

public static void center(org.eclipse.swt.widgets.Shell parent,
                          org.eclipse.swt.widgets.Composite child)

Ein Objekt innerhalb des parents zentrieren

center

public static void center(org.eclipse.swt.widgets.Shell parent,
                          org.eclipse.swt.widgets.Shell child)

Ein Objekt innerhalb des parents zentrieren

center

public static void center(org.eclipse.swt.widgets.Shell child)

Ein Objekt auf dem Bildschirm zentrieren. Robust. Sollte nie eine Exception werfen. Ändert im Zweifelsfall nichts an der Position.

writeCentered

public static void writeCentered(org.eclipse.swt.graphics.GC gc,
                                 java.lang.String text,
                                 org.eclipse.swt.graphics.Rectangle bounds)

Einen Text zentriert in ein Rechteck schreiben

alert

public static void alert(java.lang.String title,
                         java.lang.String message)

Eine Alertbox anzeigen (synchron)

showError

public static void showError(java.lang.String title,
                             java.lang.String message)

Eine Standard-Fehlermeldung asynchron im UI-Thread zeigen

Parameters:

title - Titel

message - Nachricht

showError

public static void showError(java.lang.String logHeader,
                             java.lang.String title,
                             java.lang.String message)

Eine Standard-Fehlermeldung asynchron zeigen und loggen

Parameters:

title - Titel

message - Nachricht

showInfo

public static void showInfo(java.lang.String title,
                            java.lang.String message)

Eine Standard-Infomeldung asynchron zeigen

Parameters:

title - Titel

message - Nachricht

askYesNo

public static boolean askYesNo(java.lang.String title,
                               java.lang.String message)

Eine mit Ja oder Nein zu beantwortende Frage im UI-Thread zeigen

Parameters:

title - Titel

message - Nachricht

Returns:

true: User hat Ja geklickt

askYesNoCancel

public static java.lang.Boolean askYesNoCancel(java.lang.String title,
                                               java.lang.String message)

Eine mit Ja, Nein oder Abbrechen zu beantwortende Frage im UI-Thread zeigen

Parameters:

title - Titel

message - Nachricht

Returns:

true: User hat Ja geklickt

getFillGridData

public static org.eclipse.swt.layout.GridData getFillGridData()

Shortcut for getFillGridData(1,true,1,true);

Returns:

getFillGridData

public static org.eclipse.swt.layout.GridData getFillGridData(int hSpan,
                                                              boolean hFill,
                                                              int vSpan,
                                                              boolean vFill)

Ein GridData-Objekt erzeugen, das den horizontalen und/oder vertikalen Freiraum ausfüllt.

Parameters:

horizontal - true, wenn horizontal gefüllt werden soll

vertical - true, wenn vertikal gefüllt werden soll.

Returns:

ein neu erzeugtes, direkt verwendbares GridData-Objekt

fillGrid

public static org.eclipse.swt.layout.GridData fillGrid(org.eclipse.swt.widgets.Composite parent,
                                                       int cols)

setGridDataHeight

public static org.eclipse.swt.layout.GridData setGridDataHeight(org.eclipse.swt.widgets.Control control,
                                                                int lines,
                                                                boolean fillHorizontal)

Set a GridData to the given Control that sets the specified height in lines calculated with the control's current font.

Parameters:

control - the control

lines - reuqested height of the control in lines

fillHorizontal - true if the control should require all horizontal space

Returns:

the GridData (that is already set to the control)

createTableWrapLayout

public static org.eclipse.ui.forms.widgets.TableWrapLayout createTableWrapLayout(int numColumns,
                                                                                 boolean makeColumnsEqualWidth)

Constructor wrapper for TableWrapLayout, so that parameters are identical to GridLayout(numColumns, makeColumnsEqualWidth)

getFillTableWrapData

public static org.eclipse.ui.forms.widgets.TableWrapData getFillTableWrapData(int hSpan,
                                                                              boolean hFill,
                                                                              int vSpan,
                                                                              boolean vFill)

Ein TableWrapDAta-Objekt erzeugen, das den horizontalen und/oder vertikalen Freiraum ausfüllt.

Parameters:

horizontal - true, wenn horizontal gefüllt werden soll

vertical - true, wenn vertikal gefüllt werden soll.

Returns:

ein neu erzeugtes, direkt verwendbares GridData-Objekt

getContrast

public static org.eclipse.swt.graphics.Color getContrast(org.eclipse.swt.graphics.Color col)

Return a color that contrasts optimally to the given color

Parameters:

col - an SWT Color

Returns:

black if col was rather bright, white if col was rather dark.

createHyperlink

public static org.eclipse.swt.widgets.Label createHyperlink(org.eclipse.swt.widgets.Composite parent,
                                                            java.lang.String text,
                                                            org.eclipse.ui.forms.events.IHyperlinkListener lis)

Return a Label that acts as a hyperlink

Parameters:

parent - parent control

text - text to display

lis - hyperlink listener that is called on Mouse click

Returns:

a Label

createText

public static org.eclipse.swt.widgets.Text createText(org.eclipse.swt.widgets.Composite parent,
                                                      int lines,
                                                      int flags)

Create a multiline text widget with a specified height in lines (calculated with the Text's default font)

Parameters:

parent - parent composite

lines - requested height of the text field

flags - creation flags (SWT.MULTI and SWT.WRAP are added automatocally)

Returns:

a Text control

createText

public static org.eclipse.swt.widgets.Text createText(org.eclipse.ui.forms.widgets.FormToolkit tk,
                                                      org.eclipse.swt.widgets.Composite parent,
                                                      int lines,
                                                      int flags)

createLabeledField

public static LabeledInputField createLabeledField(org.eclipse.swt.widgets.Composite parent,
                                                   java.lang.String label,
                                                   LabeledInputField.Typ typ)

blameEmptyString

public static boolean blameEmptyString(java.lang.String test,
                                       java.lang.String name)

Check whether the String is empty and give an error message if so

Parameters:

test - the String to test

name - the name for the String

Returns:

false if it was empty

setSelectOnFocus

public static void setSelectOnFocus(org.eclipse.swt.widgets.Text text)

Adds a FocusListener to text so that the text is selected as soon as the control gets the focus. The selection is cleared when the focus is lost.

Parameters:

text - the Text control to add a focus listener to

createAWTFontFromSWTFont

public static java.awt.Font createAWTFontFromSWTFont(org.eclipse.swt.graphics.Font swtFont)

size

public static int size(org.eclipse.swt.graphics.Rectangle r)

getStringBounds

public static org.eclipse.swt.graphics.Point getStringBounds(org.eclipse.swt.widgets.Composite c,
                                                             java.lang.String s)

addSeparator

public static void addSeparator(org.eclipse.swt.widgets.Composite parent)

Convenience method to add a separator bar to the composite.

The parent composite must have a GridLayout. The separator bar will span all columns of the parent grid layout.

Code from: http://www.softwarerevolution.com/blueprints/ The Software Revolution Inc. by Thomas Holland under GPLv3

Parameters:

parent - Composite

reloadViewPart

public static void reloadViewPart(java.lang.String viewID)

This method "reloads" a view, by closing and opening it. It is the programmatical equivalent to closing a view and then select Open/View/and the view ID. This method should NOT be used, as it identifies an architectural problem. The UI itself should support the respective update.

Parameters:

viewID -