## 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 JavaTM 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
    Constructor | Description
    --- | ---
    `Applet()` 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`.
    `protected abstract java.awt.peer.ButtonPeer` | Toolkit.`createButton(Button target)` Creates this toolkit's implementation of `Button` using the specified peer interface.
    `protected abstract java.awt.peer.CheckboxPeer` | Toolkit.`createCheckbox(Checkbox target)` Creates this toolkit's implementation of `Checkbox` using the specified peer interface.
    `protected abstract java.awt.peer.CheckboxMenuItemPeer` | Toolkit.`createCheckboxMenuItem(CheckboxMenuItem target)` Creates this toolkit's implementation of `CheckboxMenuItem` using the specified peer interface.
    `protected abstract java.awt.peer.ChoicePeer` | Toolkit.`createChoice(Choice target)` Creates this toolkit's implementation of `Choice` using the specified peer interface.
    `Cursor` | Toolkit.`createCustomCursor(Image cursor, Point hotSpot, String name)` Creates a new custom cursor object.
    `protected abstract java.awt.peer.DesktopPeer` | Toolkit.`createDesktopPeer(Desktop target)` Creates this toolkit's implementation of the `Desktop` using the specified peer interface.
    `protected abstract java.awt.peer.DialogPeer` | Toolkit.`createDialog(Dialog target)` Creates this toolkit's implementation of `Dialog` using the specified peer interface.
    `protected abstract java.awt.peer.FileDialogPeer` | Toolkit.`createFileDialog(FileDialog target)` Creates this toolkit's implementation of `FileDialog` using the specified peer interface.
    `protected abstract java.awt.peer.FramePeer` | Toolkit.`createFrame(Frame target)` Creates this toolkit's implementation of `Frame` using the specified peer interface.
    `protected abstract java.awt.peer.LabelPeer` | Toolkit.`createLabel(Label target)` Creates this toolkit's implementation of `Label` using the specified peer interface.
    `protected abstract java.awt.peer.ListPeer` | Toolkit.`createList(List target)` Creates this toolkit's implementation of `List` using the specified peer interface.
    `protected abstract java.awt.peer.MenuPeer` | Toolkit.`createMenu(Menu target)` Creates this toolkit's implementation of `Menu` using the specified peer interface.
    `protected abstract java.awt.peer.MenuBarPeer` | Toolkit.`createMenuBar(MenuBar target)` Creates this toolkit's implementation of `MenuBar` using the specified peer interface.
    `protected abstract java.awt.peer.MenuItemPeer` | Toolkit.`createMenuItem(MenuItem target)` Creates this toolkit's implementation of `MenuItem` using the specified peer interface.
    `protected abstract java.awt.peer.PopupMenuPeer` | Toolkit.`createPopupMenu(PopupMenu target)` Creates this toolkit's implementation of `PopupMenu` using the specified peer interface.
    `protected abstract java.awt.peer.ScrollbarPeer` | Toolkit.`createScrollbar(Scrollbar target)` Creates this toolkit's implementation of `Scrollbar` using the specified peer interface.
    `protected abstract java.awt.peer.ScrollPanePeer` | Toolkit.`createScrollPane(ScrollPane target)` Creates this toolkit's implementation of `ScrollPane` using the specified peer interface.
    `protected abstract java.awt.peer.TextAreaPeer` | Toolkit.`createTextArea(TextArea target)` Creates this toolkit's implementation of `TextArea` using the specified peer interface.
    `protected abstract java.awt.peer.TextFieldPeer` | Toolkit.`createTextField(TextField target)` Creates this toolkit's implementation of `TextField` using the specified peer interface.
    `protected abstract java.awt.peer.WindowPeer` | Toolkit.`createWindow(Window target)` Creates this toolkit's implementation of `Window` using the specified peer interface.
    `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()` Determines which 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 active (both set in program ( `isDynamicLayoutSet()` ) , and supported by 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
    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
    Constructor | Description
    --- | ---
    `DragSource()` Creates a new `DragSource`.
    `DropTarget()` Creates a `DropTarget`.
    `DropTarget(Component c, DropTargetListener dtl)` Creates a `DropTarget` given the `Component` to associate itself with, and the `DropTargetListener` to handle event processing.
    `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`).

  - ### 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
    --- | --- | ---
    `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.
    `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.
    `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.
    `int` | JFileChooser.`showDialog(Component parent, String approveButtonText)` Pops a custom file chooser dialog with a custom approve button.
    `static Color` | JColorChooser.`showDialog(Component component, String title, Color initialColor)` Shows a modal color-chooser dialog and blocks until the dialog is hidden.
    `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
    Constructor | Description
    --- | ---
    `JApplet()` 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.

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.