Module javafx.controls
Package javafx.scene.control

## Class DialogEvent

- java.lang.Object
- - java.util.EventObject
  - - javafx.event.Event
    - - javafx.scene.control.DialogEvent

- All Implemented Interfaces:
    `Serializable`, `Cloneable`

      public class DialogEvent
      extends Event

  Event related to dialog showing/hiding actions. In particular, this event is used exclusively by the following methods:
  - `Dialog.onShowingProperty()`
  - `Dialog.onShownProperty()`
  - `Dialog.onHidingProperty()`
  - `Dialog.onCloseRequestProperty()`
  - `Dialog.onHiddenProperty()`
  Since:
    JavaFX 8u40
  See Also:
    `Dialog`, Serialized Form

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `static EventType<DialogEvent>` | `ANY` | Common supertype for all dialog event types.
    `static EventType<DialogEvent>` | `DIALOG_CLOSE_REQUEST` | This event is delivered to a dialog when there is an external request to close that dialog.
    `static EventType<DialogEvent>` | `DIALOG_HIDDEN` | This event occurs on dialog just after it is hidden.
    `static EventType<DialogEvent>` | `DIALOG_HIDING` | This event occurs on dialog just before it is hidden.
    `static EventType<DialogEvent>` | `DIALOG_SHOWING` | This event occurs on dialog just before it is shown.
    `static EventType<DialogEvent>` | `DIALOG_SHOWN` | This event occurs on dialog just after it is shown.

    - ### Fields inherited from class javafx.event.Event

      `consumed, eventType, NULL_SOURCE_TARGET, target`

    - ### Fields inherited from class java.util.EventObject

      `source`

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `DialogEvent​(Dialog<?> source, EventType<? extends Event> eventType)` | Construct a new `Event` with the specified event source, target and type.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `DialogEvent` | `copyFor​(Object newSource, EventTarget newTarget)` | Creates and returns a copy of this event with the specified event source and target.
    `DialogEvent` | `copyFor​(Object newSource, EventTarget newTarget, EventType<DialogEvent> type)` | Creates a copy of the given event with the given fields substituted.
    `EventType<DialogEvent>` | `getEventType()` | Gets the event type of this event.
    `String` | `toString()` | Returns a string representation of this `DialogEvent` object.

    - ### Methods inherited from class javafx.event.Event

      `clone, consume, fireEvent, getTarget, isConsumed`

    - ### Methods inherited from class java.util.EventObject

      `getSource`

    - ### Methods inherited from class java.lang.Object

      `equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Field Detail

    - #### ANY

          public static final EventType<DialogEvent> ANY

      Common supertype for all dialog event types.

    - #### DIALOG_SHOWING

          public static final EventType<DialogEvent> DIALOG_SHOWING

      This event occurs on dialog just before it is shown.

    - #### DIALOG_SHOWN

          public static final EventType<DialogEvent> DIALOG_SHOWN

      This event occurs on dialog just after it is shown.

    - #### DIALOG_HIDING

          public static final EventType<DialogEvent> DIALOG_HIDING

      This event occurs on dialog just before it is hidden.

    - #### DIALOG_HIDDEN

          public static final EventType<DialogEvent> DIALOG_HIDDEN

      This event occurs on dialog just after it is hidden.

    - #### DIALOG_CLOSE_REQUEST

          public static final EventType<DialogEvent> DIALOG_CLOSE_REQUEST

      This event is delivered to a dialog when there is an external request to close that dialog. If the event is not consumed by any installed dialog event handler, the default handler for this event closes the corresponding dialog.

  - ### Constructor Detail

    - #### DialogEvent

          public DialogEvent​(Dialog<?> source,
                             EventType<? extends Event> eventType)

      Construct a new `Event` with the specified event source, target and type. If the source or target is set to `null`, it is replaced by the `NULL_SOURCE_TARGET` value.
      Parameters:
        `source` - the event source which sent the event
        `eventType` - the event type

  - ### Method Detail

    - #### toString

          public String toString()

      Returns a string representation of this `DialogEvent` object.
      Overrides:
        `toString` in class `EventObject`
      Returns:
        a string representation of this `DialogEvent` object.

    - #### copyFor

          public DialogEvent copyFor​(Object newSource,
                                     EventTarget newTarget)

      Description copied from class: `Event`
      Creates and returns a copy of this event with the specified event source and target. If the source or target is set to `null`, it is replaced by the `NULL_SOURCE_TARGET` value.
      Overrides:
        `copyFor` in class `Event`
      Parameters:
        `newSource` - the new source of the copied event
        `newTarget` - the new target of the copied event
      Returns:
        the event copy with the new source and target

    - #### copyFor

          public DialogEvent copyFor​(Object newSource,
                                     EventTarget newTarget,
                                     EventType<DialogEvent> type)

      Creates a copy of the given event with the given fields substituted.
      Parameters:
        `newSource` - the new source of the copied event
        `newTarget` - the new target of the copied event
        `type` - the new eventType
      Returns:
        the event copy with the fields substituted

    - #### getEventType

          public EventType<DialogEvent> getEventType()

      Description copied from class: `Event`
      Gets the event type of this event. Objects of the same `Event` class can have different event types. These event types further specify what kind of event occurred.
      Overrides:
        `getEventType` in class `Event`
      Returns:
        the event type