# Uses of Class
java.awt.HeadlessException

Packages that use HeadlessException
Package
Description
java.applet
Provides the classes necessary to create an applet and the classes an applet uses to communicate with its applet context.
java.awt
Contains all of the classes for creating user interfaces and for painting graphics and images.
java.awt.dnd
Drag and Drop is a direct manipulation gesture found in many Graphical User Interface systems that provides a mechanism to transfer information between two entities logically associated with presentation elements in the GUI.
java.awt.print
Provides classes and interfaces for a general printing API.
javax.print
Provides the principal classes and interfaces for the Java Print Service API.
javax.swing
Provides a set of "lightweight" (all-Java language) components that, to the maximum degree possible, work the same on all platforms.

## Uses of HeadlessException in java.applet

Constructors in java.applet that throw HeadlessException
Modifier
Constructor
Description
``
`Applet()`
Deprecated, for removal: This API element is subject to removal in a future version.
Constructs a new Applet.

## Uses of HeadlessException in java.awt

Methods in java.awt that throw HeadlessException
Modifier and Type
Method
Description
`boolean`
Toolkit.`areExtraMouseButtonsEnabled()`
Reports whether events from extra mouse buttons are allowed to be processed and posted into `EventQueue`.
`Cursor`
Toolkit.`createCustomCursor(Image cursor, Point hotSpot, String name)`
Creates a new custom cursor object.
`Dimension`
Toolkit.`getBestCursorSize(int preferredWidth, int preferredHeight)`
Returns the supported cursor dimension which is closest to the desired sizes.
`Point`
GraphicsEnvironment.`getCenterPoint()`
Returns the Point where Windows should be centered.
`abstract ColorModel`
Toolkit.`getColorModel()`
Determines the color model of this toolkit's screen.
`abstract GraphicsDevice`
GraphicsEnvironment.`getDefaultScreenDevice()`
Returns the default screen `GraphicsDevice`.
`int`
Toolkit.`getMaximumCursorColors()`
Returns the maximum number of colors the Toolkit supports in a custom cursor palette.
`Rectangle`
GraphicsEnvironment.`getMaximumWindowBounds()`
Returns the maximum bounds for centered Windows.
`int`
Toolkit.`getMenuShortcutKeyMask()`
Deprecated.
It is recommended that extended modifier keys and `Toolkit.getMenuShortcutKeyMaskEx()` be used instead
`int`
Toolkit.`getMenuShortcutKeyMaskEx()`
Determines which extended modifier key is the appropriate accelerator key for menu shortcuts.
`Point`
Component.`getMousePosition()`
Returns the position of the mouse pointer in this `Component`'s coordinate space if the `Component` is directly under the mouse pointer, otherwise returns `null`.
`Point`
Container.`getMousePosition(boolean allowChildren)`
Returns the position of the mouse pointer in this `Container`'s coordinate space if the `Container` is under the mouse pointer, otherwise returns `null`.
`static int`
MouseInfo.`getNumberOfButtons()`
Returns the number of buttons on the mouse.
`static PointerInfo`
MouseInfo.`getPointerInfo()`
Returns a `PointerInfo` instance that represents the current location of the mouse pointer.
`abstract GraphicsDevice[]`
GraphicsEnvironment.`getScreenDevices()`
Returns an array of all of the screen `GraphicsDevice` objects.
`Insets`
Toolkit.`getScreenInsets(GraphicsConfiguration gc)`
Gets the insets of the screen.
`abstract int`
Toolkit.`getScreenResolution()`
Returns the screen resolution in dots-per-inch.
`abstract Dimension`
Toolkit.`getScreenSize()`
Gets the size of the screen.
`abstract Clipboard`
Toolkit.`getSystemClipboard()`
Gets the singleton instance of the system Clipboard which interfaces with clipboard facilities provided by the native platform.
`static Cursor`
Cursor.`getSystemCustomCursor(String name)`
Returns a system-specific custom cursor object matching the specified name.
`Clipboard`
Toolkit.`getSystemSelection()`
Gets the singleton instance of the system selection as a `Clipboard` object.
`boolean`
Toolkit.`isDynamicLayoutActive()`
Returns whether dynamic layout of Containers on resize is currently enabled on the underlying operating system and/or window manager.
`protected boolean`
Toolkit.`isDynamicLayoutSet()`
Returns whether the layout of Containers is validated dynamically during resizing, or statically, after resizing is complete.
`boolean`
Toolkit.`isFrameStateSupported(int state)`
Returns whether Toolkit supports this state for `Frame`s.
`protected void`
Toolkit.`loadSystemColors(int[] systemColors)`
Fills in the integer array that is supplied as an argument with the current system color values.
`abstract Map<TextAttribute,?>`
Toolkit.`mapInputMethodHighlight(InputMethodHighlight highlight)`
Returns a map of visual attributes for the abstract level description of the given input method highlight, or null if no mapping is found.
`void`
Toolkit.`setDynamicLayout(boolean dynamic)`
Controls whether the layout of Containers is validated dynamically during resizing, or statically, after resizing is complete.
Constructors in java.awt that throw HeadlessException
Modifier
Constructor
Description
``
`Button()`
Constructs a button with an empty string for its label.
``
`Button(String label)`
Constructs a button with the specified label.
``
`Checkbox()`
Creates a check box with an empty string for its label.
``
`Checkbox(String label)`
Creates a check box with the specified label.
``
`Checkbox(String label, boolean state)`
Creates a check box with the specified label and sets the specified state.
``
`Checkbox(String label, boolean state, CheckboxGroup group)`
Constructs a Checkbox with the specified label, set to the specified state, and in the specified check box group.
``
`Checkbox(String label, CheckboxGroup group, boolean state)`
Creates a check box with the specified label, in the specified check box group, and set to the specified state.
``
`CheckboxMenuItem()`
Create a check box menu item with an empty label.
``
`CheckboxMenuItem(String label)`
Create a check box menu item with the specified label.
``
`CheckboxMenuItem(String label, boolean state)`
Create a check box menu item with the specified label and state.
``
`Choice()`
Creates a new choice menu.
``
`Frame()`
Constructs a new instance of `Frame` that is initially invisible.
``
`Frame(String title)`
Constructs a new, initially invisible `Frame` object with the specified title.
``
`Label()`
Constructs an empty label.
``
`Label(String text)`
Constructs a new label with the specified string of text, left justified.
``
`Label(String text, int alignment)`
Constructs a new label that presents the specified string of text with the specified alignment.
``
`List()`
Creates a new scrolling list.
``
`List(int rows)`
Creates a new scrolling list initialized with the specified number of visible lines.
``
`List(int rows, boolean multipleMode)`
Creates a new scrolling list initialized to display the specified number of rows.
``
`Menu()`
Constructs a new menu with an empty label.
``
`Menu(String label)`
Constructs a new menu with the specified label.
``
`Menu(String label, boolean tearOff)`
Constructs a new menu with the specified label, indicating whether the menu can be torn off.
``
`MenuBar()`
Creates a new menu bar.
``
`MenuComponent()`
Creates a `MenuComponent`.
``
`MenuItem()`
Constructs a new MenuItem with an empty label and no keyboard shortcut.
``
`MenuItem(String label)`
Constructs a new MenuItem with the specified label and no keyboard shortcut.
``
`MenuItem(String label, MenuShortcut s)`
Create a menu item with an associated keyboard shortcut.
``
`PopupMenu()`
Creates a new popup menu with an empty name.
``
`PopupMenu(String label)`
Creates a new popup menu with the specified name.
``
`Scrollbar()`
Constructs a new vertical scroll bar.
``
`Scrollbar(int orientation)`
Constructs a new scroll bar with the specified orientation.
``
`Scrollbar(int orientation, int value, int visible, int minimum, int maximum)`
Constructs a new scroll bar with the specified orientation, initial value, visible amount, and minimum and maximum values.
``
`ScrollPane()`
Create a new scrollpane container with a scrollbar display policy of "as needed".
``
`ScrollPane(int scrollbarDisplayPolicy)`
Create a new scrollpane container.
``
`TextArea()`
Constructs a new text area with the empty string as text.
``
`TextArea(int rows, int columns)`
Constructs a new text area with the specified number of rows and columns and the empty string as text.
``
`TextArea(String text)`
Constructs a new text area with the specified text.
``
`TextArea(String text, int rows, int columns)`
Constructs a new text area with the specified text, and with the specified number of rows and columns.
``
`TextArea(String text, int rows, int columns, int scrollbars)`
Constructs a new text area with the specified text, and with the rows, columns, and scroll bar visibility as specified.
``
`TextField()`
Constructs a new text field.
``
`TextField(int columns)`
Constructs a new empty text field with the specified number of columns.
``
`TextField(String text)`
Constructs a new text field initialized with the specified text.
``
`TextField(String text, int columns)`
Constructs a new text field initialized with the specified text to be displayed, and wide enough to hold the specified number of columns.

## Uses of HeadlessException in java.awt.dnd

Constructors in java.awt.dnd that throw HeadlessException
Modifier
Constructor
Description
``
`DragSource()`
Creates a new `DragSource`.
``
`DropTarget()`
Creates a `DropTarget`.
``
`DropTarget(Component c, int ops, DropTargetListener dtl)`
Creates a `DropTarget` given the `Component` to associate itself with, an `int` representing the default acceptable action(s) to support, and a `DropTargetListener` to handle event processing.
``
`DropTarget(Component c, int ops, DropTargetListener dtl, boolean act)`
Creates a `DropTarget` given the `Component` to associate itself with, an `int` representing the default acceptable action(s) to support, a `DropTargetListener` to handle event processing, and a `boolean` indicating if the `DropTarget` is currently accepting drops.
``
`DropTarget(Component c, int ops, DropTargetListener dtl, boolean act, FlavorMap fm)`
Creates a new DropTarget given the `Component` to associate itself with, an `int` representing the default acceptable action(s) to support, a `DropTargetListener` to handle event processing, a `boolean` indicating if the `DropTarget` is currently accepting drops, and a `FlavorMap` to use (or null for the default `FlavorMap`).
``
`DropTarget(Component c, DropTargetListener dtl)`
Creates a `DropTarget` given the `Component` to associate itself with, and the `DropTargetListener` to handle event processing.

## Uses of HeadlessException in java.awt.print

Methods in java.awt.print that throw HeadlessException
Modifier and Type
Method
Description
`abstract PageFormat`
PrinterJob.`pageDialog(PageFormat page)`
Displays a dialog that allows modification of a `PageFormat` instance.
`PageFormat`
PrinterJob.`pageDialog(PrintRequestAttributeSet attributes)`
A convenience method which displays a cross-platform page setup dialog.
`abstract boolean`
PrinterJob.`printDialog()`
Presents a dialog to the user for changing the properties of the print job.
`boolean`
PrinterJob.`printDialog(PrintRequestAttributeSet attributes)`
A convenience method which displays a cross-platform print dialog for all services which are capable of printing 2D graphics using the `Pageable` interface.

## Uses of HeadlessException in javax.print

Methods in javax.print that throw HeadlessException
Modifier and Type
Method
Description
`static PrintService`
ServiceUI.`printDialog(GraphicsConfiguration gc, int x, int y, PrintService[] services, PrintService defaultService, DocFlavor flavor, PrintRequestAttributeSet attributes)`
Presents a dialog to the user for selecting a print service (printer).

## Uses of HeadlessException in javax.swing

Methods in javax.swing that throw HeadlessException
Modifier and Type
Method
Description
`static JDialog`
JColorChooser.`createDialog(Component c, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener)`
Creates and returns a new dialog containing the specified `ColorChooser` pane along with "OK", "Cancel", and "Reset" buttons.
`protected JDialog`
JFileChooser.`createDialog(Component parent)`
Creates and returns a new `JDialog` wrapping `this` centered on the `parent` in the `parent`'s frame.
`JDialog`
JOptionPane.`createDialog(Component parentComponent, String title)`
Creates and returns a new `JDialog` wrapping `this` centered on the `parentComponent` in the `parentComponent`'s frame.
`JDialog`
JOptionPane.`createDialog(String title)`
Creates and returns a new parentless `JDialog` with the specified title.
`static Frame`
JOptionPane.`getFrameForComponent(Component parentComponent)`
Returns the specified component's `Frame`.
`static Frame`
JOptionPane.`getRootFrame()`
Returns the `Frame` to use for the class methods in which a frame is not provided.
`boolean`
JTable.`print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive)`
Prints this table, as specified by the fully featured `print` method, with the default printer specified as the print service.
`boolean`
JTable.`print(JTable.PrintMode printMode, MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintRequestAttributeSet attr, boolean interactive, PrintService service)`
Prints this `JTable`.
`static int`
JOptionPane.`showConfirmDialog(Component parentComponent, Object message)`
Brings up a dialog with the options Yes, No and Cancel; with the title, Select an Option.
`static int`
JOptionPane.`showConfirmDialog(Component parentComponent, Object message, String title, int optionType)`
Brings up a dialog where the number of choices is determined by the `optionType` parameter.
`static int`
JOptionPane.`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType)`
Brings up a dialog where the number of choices is determined by the `optionType` parameter, where the `messageType` parameter determines the icon to display.
`static int`
JOptionPane.`showConfirmDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon)`
Brings up a dialog with a specified icon, where the number of choices is determined by the `optionType` parameter.
`static Color`
JColorChooser.`showDialog(Component component, String title, Color initialColor)`
Shows a modal color-chooser dialog and blocks until the dialog is hidden.
`static Color`
JColorChooser.`showDialog(Component component, String title, Color initialColor, boolean colorTransparencySelectionEnabled)`
Shows a modal color-chooser dialog and blocks until the dialog is hidden.
`int`
JFileChooser.`showDialog(Component parent, String approveButtonText)`
Pops a custom file chooser dialog with a custom approve button.
`static String`
JOptionPane.`showInputDialog(Component parentComponent, Object message)`
Shows a question-message dialog requesting input from the user parented to `parentComponent`.
`static String`
JOptionPane.`showInputDialog(Component parentComponent, Object message, String title, int messageType)`
Shows a dialog requesting input from the user parented to `parentComponent` with the dialog having the title `title` and message type `messageType`.
`static Object`
JOptionPane.`showInputDialog(Component parentComponent, Object message, String title, int messageType, Icon icon, Object[] selectionValues, Object initialSelectionValue)`
Prompts the user for input in a blocking dialog where the initial selection, possible selections, and all other options can be specified.
`static String`
JOptionPane.`showInputDialog(Object message)`
Shows a question-message dialog requesting input from the user.
`static void`
JOptionPane.`showMessageDialog(Component parentComponent, Object message)`
Brings up an information-message dialog titled "Message".
`static void`
JOptionPane.`showMessageDialog(Component parentComponent, Object message, String title, int messageType)`
Brings up a dialog that displays a message using a default icon determined by the `messageType` parameter.
`static void`
JOptionPane.`showMessageDialog(Component parentComponent, Object message, String title, int messageType, Icon icon)`
Brings up a dialog displaying a message, specifying all parameters.
`int`
JFileChooser.`showOpenDialog(Component parent)`
Pops up an "Open File" file chooser dialog.
`static int`
JOptionPane.`showOptionDialog(Component parentComponent, Object message, String title, int optionType, int messageType, Icon icon, Object[] options, Object initialValue)`
Brings up a dialog with a specified icon, where the initial choice is determined by the `initialValue` parameter and the number of choices is determined by the `optionType` parameter.
`int`
JFileChooser.`showSaveDialog(Component parent)`
Pops up a "Save File" file chooser dialog.
Constructors in javax.swing that throw HeadlessException
Modifier
Constructor
Description
``
`JApplet()`
Deprecated, for removal: This API element is subject to removal in a future version.
Creates a swing applet instance.
``
`JFrame()`
Constructs a new frame that is initially invisible.
``
`JFrame(String title)`
Creates a new, initially invisible `Frame` with the specified title.