Package org.eclipse.jface.dialogs
Class IconAndMessageDialog
- java.lang.Object
-
- org.eclipse.jface.window.Window
-
- org.eclipse.jface.dialogs.Dialog
-
- org.eclipse.jface.dialogs.IconAndMessageDialog
-
- All Implemented Interfaces:
IShellProvider
- Direct Known Subclasses:
ErrorDialog,MessageDialog,PlainMessageDialog,ProgressMonitorDialog
public abstract class IconAndMessageDialog extends Dialog
The IconAndMessageDialog is the abstract superclass of dialogs that have an icon and a message as the first two widgets. In this dialog the icon and message are direct children of the shell in order that they can be read by accessibility tools more easily.Note: Clients are expected to call
createMessageArea(Composite), otherwise neither the icon nor the message will appear.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.eclipse.jface.window.Window
Window.IExceptionHandler
-
-
Field Summary
Fields Modifier and Type Field Description protected LabelimageLabelReturn the label for the image.protected StringmessageMessage (a localized string).protected LabelmessageLabelMessage label is the label the message is shown on.-
Fields inherited from class org.eclipse.jface.dialogs.Dialog
blockedHandler, buttonBar, DIALOG_DEFAULT_BOUNDS, DIALOG_PERSISTLOCATION, DIALOG_PERSISTSIZE, dialogArea, DLG_IMG_ERROR, DLG_IMG_HELP, DLG_IMG_INFO, DLG_IMG_MESSAGE_ERROR, DLG_IMG_MESSAGE_INFO, DLG_IMG_MESSAGE_WARNING, DLG_IMG_QUESTION, DLG_IMG_WARNING, ELLIPSIS
-
Fields inherited from class org.eclipse.jface.window.Window
CANCEL, OK, resizeHasOccurred
-
-
Constructor Summary
Constructors Constructor Description IconAndMessageDialog(Shell parentShell)Constructor for IconAndMessageDialog.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected ControlcreateButtonBar(Composite parent)Creates and returns the contents of this dialog's button bar.protected ControlcreateContents(Composite parent)TheDialogimplementation of thisWindowmethod creates and lays out the top level composite for the dialog, and determines the appropriate horizontal and vertical dialog units based on the font size.protected voidcreateDialogAndButtonArea(Composite parent)Create the dialog area and the button bar for the receiver.protected ControlcreateMessageArea(Composite composite)Create the area the message will be shown in.protected intgetColumnCount()Get the number of columns in the layout of the Shell of the dialog.ImagegetErrorImage()Return theImageto be used when displaying an error.protected abstract ImagegetImage()Returns the image to display beside the message in this dialog.ImagegetInfoImage()Return theImageto be used when displaying information.protected intgetMessageLabelStyle()Returns the style for the message label.ImagegetQuestionImage()Return theImageto be used when displaying a question.ImagegetWarningImage()Return theImageto be used when displaying a warning.-
Methods inherited from class org.eclipse.jface.dialogs.Dialog
applyDialogFont, buttonPressed, cancelPressed, close, convertHeightInCharsToPixels, convertHeightInCharsToPixels, convertHorizontalDLUsToPixels, convertHorizontalDLUsToPixels, convertVerticalDLUsToPixels, convertVerticalDLUsToPixels, convertWidthInCharsToPixels, convertWidthInCharsToPixels, create, createButton, createButtonsForButtonBar, createDialogArea, dialogFontIsDefault, getBlockedHandler, getButton, getButtonBar, getCancelButton, getDialogArea, getDialogBoundsSettings, getDialogBoundsStrategy, getImage, getInitialLocation, getInitialSize, getOKButton, initializeBounds, initializeDialogUnits, isResizable, okPressed, setBlockedHandler, setButtonLayoutData, setButtonLayoutFormData, shortenText
-
Methods inherited from class org.eclipse.jface.window.Window
canHandleShellCloseEvent, configureShell, constrainShellSize, createShell, getConstrainedShellBounds, getContents, getDefaultImage, getDefaultImages, getDefaultOrientation, getLayout, getParentShell, getReturnCode, getShell, getShellListener, getShellStyle, getWindowManager, handleFontChange, handleShellCloseEvent, open, setBlockOnOpen, setDefaultImage, setDefaultImages, setDefaultModalParent, setDefaultOrientation, setExceptionHandler, setParentShell, setReturnCode, setShellStyle, setWindowManager
-
-
-
-
Constructor Detail
-
IconAndMessageDialog
public IconAndMessageDialog(Shell parentShell)
Constructor for IconAndMessageDialog.- Parameters:
parentShell- the parent shell, ornullto create a top-level shell
-
-
Method Detail
-
createMessageArea
protected Control createMessageArea(Composite composite)
Create the area the message will be shown in.The parent composite is assumed to use GridLayout as its layout manager, since the parent is typically the composite created in
Dialog.createDialogArea(org.eclipse.swt.widgets.Composite).Note: Clients are expected to call this method, otherwise neither the icon nor the message will appear.
- Parameters:
composite- The composite to parent from.- Returns:
- Control
-
getMessageLabelStyle
protected int getMessageLabelStyle()
Returns the style for the message label.- Returns:
- the style for the message label
- Since:
- 3.0
-
createButtonBar
protected Control createButtonBar(Composite parent)
Description copied from class:DialogCreates and returns the contents of this dialog's button bar.The
Dialogimplementation of this framework method lays out a button bar and calls thecreateButtonsForButtonBarframework method to populate it. Subclasses may override.The returned control's layout data must be an instance of
GridData.- Overrides:
createButtonBarin classDialog- Parameters:
parent- the parent composite to contain the button bar- Returns:
- the button bar control
-
getImage
protected abstract Image getImage()
Returns the image to display beside the message in this dialog.Subclasses may override.
- Returns:
- the image to display beside the message
- Since:
- 2.0
-
createContents
protected Control createContents(Composite parent)
Description copied from class:DialogTheDialogimplementation of thisWindowmethod creates and lays out the top level composite for the dialog, and determines the appropriate horizontal and vertical dialog units based on the font size. It then calls thecreateDialogAreaandcreateButtonBarmethods to create the dialog area and button bar, respectively. OverridingcreateDialogAreaandcreateButtonBarare recommended rather than overriding this method.- Overrides:
createContentsin classDialog- Parameters:
parent- the parent composite for the controls in this window. The type of layout used is determined by getLayout()- Returns:
- the control that will be returned by subsequent calls to getContents()
-
getColumnCount
protected int getColumnCount()
Get the number of columns in the layout of the Shell of the dialog.- Returns:
- int
- Since:
- 3.22
-
createDialogAndButtonArea
protected void createDialogAndButtonArea(Composite parent)
Create the dialog area and the button bar for the receiver.- Parameters:
parent- the parent composite
-
getErrorImage
public Image getErrorImage()
Return theImageto be used when displaying an error.- Returns:
- image the error image
-
getWarningImage
public Image getWarningImage()
Return theImageto be used when displaying a warning.- Returns:
- image the warning image
-
getInfoImage
public Image getInfoImage()
Return theImageto be used when displaying information.- Returns:
- image the information image
-
getQuestionImage
public Image getQuestionImage()
Return theImageto be used when displaying a question.- Returns:
- image the question image
-
-