jdk

1
/*
2
 * Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved.
3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4
 *
5
 * This code is free software; you can redistribute it and/or modify it
6
 * under the terms of the GNU General Public License version 2 only, as
7
 * published by the Free Software Foundation.  Oracle designates this
8
 * particular file as subject to the "Classpath" exception as provided
9
 * by Oracle in the LICENSE file that accompanied this code.
10
 *
11
 * This code is distributed in the hope that it will be useful, but WITHOUT
12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14
 * version 2 for more details (a copy is included in the LICENSE file that
15
 * accompanied this code).
16
 *
17
 * You should have received a copy of the GNU General Public License version
18
 * 2 along with this work; if not, write to the Free Software Foundation,
19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20
 *
21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22
 * or visit www.oracle.com if you need additional information or have any
23
 * questions.
24
 */
25

26
package java.awt.desktop;
27

28
import java.awt.Desktop;
29
import java.awt.GraphicsEnvironment;
30
import java.awt.HeadlessException;
31
import java.io.Serial;
32
import java.util.EventObject;
33

34
/**
35
 * AppEvents are sent to listeners and handlers installed on the
36
 * {@link java.awt.Desktop} instance of the current desktop context.
37
 *
38
 * @since 9
39
 * @sealedGraph
40
 */
41
public sealed class AppEvent extends EventObject
42
    permits AboutEvent,
43
            AppForegroundEvent,
44
            AppHiddenEvent,
45
            AppReopenedEvent,
46
            FilesEvent,
47
            OpenURIEvent,
48
            PreferencesEvent,
49
            QuitEvent,
50
            ScreenSleepEvent,
51
            SystemSleepEvent,
52
            UserSessionEvent {
53

54
    /**
55
     * Use serialVersionUID from JDK 9 for interoperability.
56
     */
57
    @Serial
58
    private static final long serialVersionUID = -5958503993556009432L;
59

60
    /**
61
     * Constructs an {@code AppEvent}.
62
     *
63
     * @throws HeadlessException if {@link GraphicsEnvironment#isHeadless()}
64
     *         returns {@code true}
65
     * @throws UnsupportedOperationException if Desktop API is not supported on
66
     *         the current platform
67
     * @see Desktop#isDesktopSupported()
68
     * @see java.awt.GraphicsEnvironment#isHeadless
69
     */
70
    AppEvent() {
71
        super(Desktop.getDesktop());
72
    }
73
}
74