mirrors/JetBrainsRuntime
1
0
Fork 0
mirror of https://github.com/JetBrains/JetBrainsRuntime.git synced 2026-01-08 01:21:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

8175266: Use package-info.java instead of package.html within swing packages

Browse Source 
Reviewed-by: alexsch
This commit is contained in:
Sergey Bylokhov
2017-02-26 23:34:34 +03:00
parent 54b4e49ec2
commit cd8415af87
36 changed files with 1133 additions and 1355 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
jdk/src/java.desktop/share/classes/javax/swing/border/package-info.java Normal file
View File

@@ -0,0 +1,53 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides classes and interface for drawing specialized borders around a Swing
* component. You can subclass these classes to create customized borders for
* your components instead of using the default borders provided by the
* look-and-feel being used.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/border.html"
* target="_top">How to Use Borders</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.border;

64
jdk/src/java.desktop/share/classes/javax/swing/border/package.html
View File

@@ -1,64 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides classes and interface for drawing
specialized borders around a Swing component.
You can subclass these classes to create customized borders
for your components instead of using the default borders
provided by the look-and-feel being used.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/border.html"
target="_top">How to Use Borders</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>

54
jdk/src/java.desktop/share/classes/javax/swing/colorchooser/package-info.java Normal file
View File

@@ -0,0 +1,54 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Contains classes and interfaces used by the {@code JColorChooser} component.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation </h2>
* This document forms the complete API specification. For overviews, tutorials,
* examples, guides, and tool documentation, please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/colorchooser.html"
* target="_top">How to Use Color Choosers</a>,
* a section in <em>The Java Tutorial</em></li>
* <li><a href="../../../../technotes/guides/intl/index.html"
* target="_top">Internationalization Documentation</a></li>
* <li><a href="../../../../technotes/guides/imf/index.html"
* target="_top">Input Method Framework Documentation</a></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.colorchooser;

66
jdk/src/java.desktop/share/classes/javax/swing/colorchooser/package.html
View File

@@ -1,66 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Contains classes and interfaces used by the <code>JColorChooser</code>
component.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation </h2>
This document forms the complete API specification. For overviews, tutorials,
examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/colorchooser.html" target="_top">How to Use Color Choosers</a>,
a section in <em>The Java Tutorial</em>
<li><a href="../../../../technotes/guides/intl/index.html"
target="_top">Internationalization Documentation</a>
<li><a href="../../../../technotes/guides/imf/index.html"
target="_top">Input Method Framework Documentation</a>
</ul>
@since 1.2
@serial exclude
</body>
</html>

52
jdk/src/java.desktop/share/classes/javax/swing/event/package-info.java Normal file
View File

@@ -0,0 +1,52 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides for events fired by Swing components. It contains event classes and
* corresponding event listener interfaces for events fired by Swing components
* in addition to those events in the {@link java.awt.event} package.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/events/index.html"
* target="_top">Writing Event Listeners</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.event;

62
jdk/src/java.desktop/share/classes/javax/swing/event/package.html
View File

@@ -1,62 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides for events fired by Swing components. It contains
event classes and corresponding event listener interfaces for events
fired by Swing components in addition to those events in the
java.awt.event package.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/events/index.html"
target="_top">Writing Event Listeners</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>

54
jdk/src/java.desktop/share/classes/javax/swing/filechooser/package-info.java Normal file
View File

@@ -0,0 +1,54 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Contains classes and interfaces used by the {@code JFileChooser} component.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation </h2>
* This document forms the complete API specification. For overviews, tutorials,
* examples, guides, and tool documentation, please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/filechooser.html"
* target="_top">How to Use File Choosers</a>,
* a section in <em>The Java Tutorial</em></li>
* <li><a href="../../../../technotes/guides/intl/index.html"
* target="_top">Internationalization Documentation</a></li>
* <li><a href="../../../../technotes/guides/imf/index.html"
* target="_top">Input Method Framework Documentation</a></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.filechooser;

65
jdk/src/java.desktop/share/classes/javax/swing/filechooser/package.html
View File

@@ -1,65 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Contains classes and interfaces used by the <code>JFileChooser</code> component.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation </h2>
This document forms the complete API specification. For overviews, tutorials,
examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/filechooser.html" target="_top">How to Use File Choosers</a>,
a section in <em>The Java Tutorial</em>
<li><a href="../../../../technotes/guides/intl/index.html"
target="_top">Internationalization Documentation</a>
<li><a href="../../../../technotes/guides/imf/index.html"
target="_top">Input Method Framework Documentation</a>
</ul>
@since 1.2
@serial exclude
</body>
</html>

130
jdk/src/java.desktop/share/classes/javax/swing/package-info.java Normal file
View File

@@ -0,0 +1,130 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides a set of &quot;lightweight&quot; (all-Java language) components
* that, to the maximum degree possible, work the same on all platforms. For a
* programmer's guide to using these components, see
* <a href="http://docs.oracle.com/javase/tutorial/uiswing/index.html"
* target="_top">Creating a GUI with JFC/Swing</a>, a trail in
* <em>The Java Tutorial</em>. For other resources, see
* <a href="#related">Related Documentation</a>.
*
* <h2><a name="threading">Swing's Threading Policy</a></h2>
* In general Swing is not thread safe. All Swing components and related
* classes, unless otherwise documented, must be accessed on the event
* dispatching thread.
* <p>
* Typical Swing applications do processing in response to an event generated
* from a user gesture. For example, clicking on a {@code JButton} notifies all
* {@code ActionListeners} added to the {@code JButton}. As all events generated
* from a user gesture are dispatched on the event dispatching thread, most
* developers are not impacted by the restriction.
* <p>
* Where the impact lies, however, is in constructing and showing a Swing
* application. Calls to an application's {@code main} method, or methods in
* {@code Applet}, are not invoked on the event dispatching thread. As such,
* care must be taken to transfer control to the event dispatching thread when
* constructing and showing an application or applet. The preferred way to
* transfer control and begin working with Swing is to use {@code invokeLater}.
* The {@code invokeLater} method schedules a {@code Runnable} to be processed
* on the event dispatching thread. The following two examples work equally well
* for transferring control and starting up a Swing application:
* <pre>
* import javax.swing.SwingUtilities;
*
* public class MyApp implements Runnable {
* public void run() {
* // Invoked on the event dispatching thread.
* // Construct and show GUI.
* }
*
* public static void main(String[] args) {
* SwingUtilities.invokeLater(new MyApp());
* }
* }</pre>
* Or:<pre>
* import javax.swing.SwingUtilities;
*
* public class MyApp {
* MyApp(String[] args) {
* // Invoked on the event dispatching thread.
* // Do any initialization here.
* }
*
* public void show() {
* // Show the UI.
* }
*
* public static void main(final String[] args) {
* // Schedule a job for the event-dispatching thread:
* // creating and showing this application's GUI.
* SwingUtilities.invokeLater(new Runnable() {
* public void run() {
* new MyApp(args).show();
* }
* });
* }
* }</pre>
* This restriction also applies to models attached to Swing components. For
* example, if a {@code TableModel} is attached to a {@code JTable}, the
* {@code TableModel} should only be modified on the event dispatching thread.
* If you modify the model on a separate thread you run the risk of exceptions
* and possible display corruption.
* <p>
* As all events are delivered on the event dispatching thread, care must be
* taken in event processing. In particular, a long running task, such as
* network io or computational intensive processing, executed on the event
* dispatching thread blocks the event dispatching thread from dispatching any
* other events. While the event dispatching thread is blocked the application
* is completely unresponsive to user input. Refer to
* {@link javax.swing.SwingWorker} for the preferred way to do such processing
* when working with Swing.
* <p>
* More information on this topic can be found in the
* <a href="http://docs.oracle.com/javase/tutorial/uiswing/">Swing tutorial</a>,
* in particular the section on
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html">
* Concurrency in Swing</a>.
*
* <h2><a name="related">Related Documentation</a></h2>
* For overviews, tutorials, examples, guides, and other documentation,
* please see:
* <ul>
* <li><a href="http://www.oracle.com/technetwork/java/javase/tech/articles-jsp-139072.html"
* target="_top">The Swing Connection</a></li>
* <li><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></li>
* <li><a href="http://www.oracle.com/technetwork/java/javase/training/index.html"
* target="_top">Online Training</a>
* at the Java Developer Connection <sup>SM</sup></li>
* <li><a href="http://www.oracle.com/technetwork/java/javase/tech/index-jsp-142216.html"
* target="_top">Java Foundation Classes (JFC)</a> home page</li>
* </ul>
*
* @serial exclude
*/
package javax.swing;

151
jdk/src/java.desktop/share/classes/javax/swing/package.html
View File

@@ -1,151 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<!--
Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<META NAME="Author" Content="Eric Armstrong">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">
<TITLE>swing package</TITLE>
</HEAD>
<BODY bgcolor="white">
<P>Provides a set of &quot;lightweight&quot;
(all-Java language) components that,
to the maximum degree possible, work the same on all platforms.
For a programmer's guide to using these components, see
<a href="http://docs.oracle.com/javase/tutorial/uiswing/index.html"
target="_top">Creating
a GUI with JFC/Swing</a>, a trail in <em>The Java Tutorial</em>.
For other resources, see
<a href="#related">Related Documentation</a>.
<H2><a name="threading">Swing's Threading Policy</a></h2>
In general Swing is not thread safe. All Swing components and related
classes, unless otherwise documented, must be accessed on the event
dispatching thread.
<p>
Typical Swing applications do processing in response to an event
generated from a user gesture. For example, clicking on a {@code
JButton} notifies all {@code ActionListeners} added to the {@code
JButton}. As all events generated from a user gesture are
dispatched on the event dispatching thread, most developers are not
impacted by the restriction.
<p>
Where the impact lies, however, is in constructing and showing a
Swing application. Calls to an application's {@code main} method,
or methods in {@code Applet}, are not invoked on the event
dispatching thread. As such, care must be taken to transfer control
to the event dispatching thread when constructing and showing an
application or applet. The preferred way to transfer control and begin
working with Swing is to use {@code invokeLater}. The {@code
invokeLater} method schedules a {@code Runnable} to be processed on
the event dispatching thread. The following two examples work equally
well for transferring control and starting up a Swing application:
<pre>
import javax.swing.SwingUtilities;
public class MyApp implements Runnable {
public void run() {
// Invoked on the event dispatching thread.
// Construct and show GUI.
}
public static void main(String[] args) {
SwingUtilities.invokeLater(new MyApp());
}
}
</pre>
Or:
<pre>
import javax.swing.SwingUtilities;
public class MyApp {
MyApp(String[] args) {
// Invoked on the event dispatching thread.
// Do any initialization here.
}
public void show() {
// Show the UI.
}
public static void main(final String[] args) {
// Schedule a job for the event-dispatching thread:
// creating and showing this application's GUI.
SwingUtilities.invokeLater(new Runnable() {
public void run() {
new MyApp(args).show();
}
});
}
}
</pre>
This restriction also applies to models attached to Swing components.
For example, if a {@code TableModel} is attached to a {@code
JTable}, the {@code TableModel} should only be modified on the
event dispatching thread. If you modify the model on a separate
thread you run the risk of exceptions and possible display
corruption.
<p>
As all events are delivered on the event dispatching thread, care must
be taken in event processing. In particular, a long running task, such
as network io or computational intensive processing, executed on the
event dispatching thread blocks the event dispatching thread from
dispatching any other events. While the event dispatching thread is
blocked the application is completely unresponsive to user
input. Refer to {@link javax.swing.SwingWorker} for the preferred way to do such
processing when working with Swing.
<p>
More information on this topic can be found in the
<a href="http://docs.oracle.com/javase/tutorial/uiswing/">Swing tutorial</a>,
in particular the section on
<a href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html">Concurrency in Swing</a>.
<H2>
<a name="related">Related Documentation</a>
</H2>
<P>For overviews, tutorials, examples, guides, and other documentation, please see:
<UL>
<LI><A HREF="http://www.oracle.com/technetwork/java/javase/tech/articles-jsp-139072.html"
target="_top">The Swing Connection</A>
<LI><A HREF="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</A>
<LI><A HREF="http://www.oracle.com/technetwork/java/javase/training/index.html"
target="_top">Online Training</A> at the Java Developer Connection<font size=-2><sup>SM</sup></font>
<LI><A HREF="http://www.oracle.com/technetwork/java/javase/tech/index-jsp-142216.html"
target="_top">Java Foundation Classes (JFC)</A> home page
</UL>
@serial exclude
</BODY>
</HTML>

55
jdk/src/java.desktop/share/classes/javax/swing/plaf/basic/package-info.java Normal file
View File

@@ -0,0 +1,55 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides user interface objects built according to the Basic look and feel.
* The Basic look and feel provides default behavior used by many look and feel
* packages. It contains components, layout managers, events, event listeners,
* and adapters. You can subclass the classes in this package to create your own
* customized look and feel.
* <p>
* These classes are designed to be used while the corresponding
* {@code LookAndFeel} class has been installed
* (<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
* Using them while a different {@code LookAndFeel} is installed may produce
* unexpected results, including exceptions. Additionally, changing the
* {@code LookAndFeel} maintained by the {@code UIManager} without updating the
* corresponding {@code ComponentUI} of any {@code JComponent}s may also produce
* unexpected results, such as the wrong colors showing up, and is generally not
* encouraged.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.2
* @serial exclude
*/
package javax.swing.plaf.basic;

68
jdk/src/java.desktop/share/classes/javax/swing/plaf/basic/package.html
View File

@@ -1,68 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides user interface objects built according to the
Basic look and feel. The Basic look and feel provides default
behavior used by many look and feel packages.
It contains components, layout managers,
events, event listeners, and adapters.
You can subclass the classes in
this package to create your own customized look and feel.
<p>These classes are designed to be used while the
corresponding <code>LookAndFeel</code> class has been
installed
(<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
Using them while a different <code>LookAndFeel</code> is installed
may produce unexpected results, including exceptions.
Additionally, changing the <code>LookAndFeel</code>
maintained by the <code>UIManager</code> without updating the
corresponding <code>ComponentUI</code> of any
<code>JComponent</code>s may also produce unexpected results,
such as the wrong colors showing up, and is generally not
encouraged.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.2
@serial exclude
</body>
</html>

52
jdk/src/java.desktop/share/classes/javax/swing/plaf/metal/package-info.java Normal file
View File

@@ -0,0 +1,52 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides user interface objects built according to the Java look and feel
* (once codenamed <em>Metal</em>), which is the default look and feel.
* <p>
* These classes are designed to be used while the corresponding
* {@code LookAndFeel} class has been installed
* (<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
* Using them while a different {@code LookAndFeel} is installed may produce
* unexpected results, including exceptions. Additionally, changing the
* {@code LookAndFeel} maintained by the {@code UIManager} without updating the
* corresponding {@code ComponentUI} of any {@code JComponent}s may also produce
* unexpected results, such as the wrong colors showing up, and is generally not
* encouraged.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.2
* @serial exclude
*/
package javax.swing.plaf.metal;

64
jdk/src/java.desktop/share/classes/javax/swing/plaf/metal/package.html
View File

@@ -1,64 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides user interface objects built according to
the Java look and feel (once codenamed <em>Metal</em>),
which is the default look and feel.
<p>These classes are designed to be used while the
corresponding <code>LookAndFeel</code> class has been
installed
(<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
Using them while a different <code>LookAndFeel</code> is installed
may produce unexpected results, including exceptions.
Additionally, changing the <code>LookAndFeel</code>
maintained by the <code>UIManager</code> without updating the
corresponding <code>ComponentUI</code> of any
<code>JComponent</code>s may also produce unexpected results,
such as the wrong colors showing up, and is generally not
encouraged.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.2
@serial exclude
</body>
</html>

52
jdk/src/java.desktop/share/classes/javax/swing/plaf/multi/package-info.java Normal file
View File

@@ -0,0 +1,52 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides user interface objects that combine two or more look and feels. When
* a component asks for its UI, this look and feel returns a multiplexing UI
* that handles all communications with both the default look and feel and one
* or more auxiliary look and feels. For example, if a user combines an
* auxiliary audio look and feel with the Motif look and feel, the
* {@code JButton.getUI} method would return an instance of
* {@code MultiButtonUI}, which would handle both a {@code MotifButtonUI} and an
* {@code AudioButtonUI}.
* <p>
* For more information, see
* <a href="doc-files/multi_tsc.html" target="_top">
* Using the Multiplexing Look and Feel.</a>
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.2
* @serial exclude
*/
package javax.swing.plaf.multi;

66
jdk/src/java.desktop/share/classes/javax/swing/plaf/multi/package.html
View File

@@ -1,66 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides user interface objects that combine two or more look and feels.
When a component asks
for its UI, this look and feel returns a
multiplexing UI that handles all communications with both the
default look and feel and one or more auxiliary look and feels.
For example, if
a user combines an auxiliary audio look and feel
with the Motif look and feel,
the <code>JButton.getUI</code> method
would return an instance of <code>MultiButtonUI</code>,
which would handle both a
<code>MotifButtonUI</code> and an <code>AudioButtonUI</code>.
<p>
For more information, see
<a href="doc-files/multi_tsc.html" target="_top">Using
the Multiplexing Look and Feel.</a>
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.2
@serial exclude
</body>
</html>

93
jdk/src/java.desktop/share/classes/javax/swing/plaf/nimbus/package-info.java Normal file
View File

@@ -0,0 +1,93 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides user interface objects built according to the cross-platform Nimbus
* look and feel.
* <p>
* Nimbus uses instances of the {@link javax.swing.Painter} interface to paint
* components. With each Swing component it associates a foreground and a
* background {@code Painter}, and there may be several painters for different
* component states.
* <p>
* Nimbus allows customizing many of its properties, including painters, by
* altering the {@link javax.swing.UIDefaults} table. Here's an example:
* <pre>
* UIManager.put("ProgressBar.tileWidth", myTileWidth);
* UIManager.put("ProgressBar[Enabled].backgroundPainter", myBgPainter);
* UIManager.put("ProgressBar[Enabled].foregroundPainter", myFgPainter);
* </pre>
* <p>
* Per-component customization is also possible. When rendering a component,
* Nimbus checks its client property named "Nimbus.Overrides". The value of this
* property should be an instance of {@code UIDefaults}. Settings from that
* table override the UIManager settings, but for that particular component
* instance only. An optional client property,
* "Nimbus.Overrides.InheritDefaults" of type Boolean, specifies whether the
* overriding settings should be merged with default ones ({@code true}), or
* replace them ({@code false}). By default they are merged:
* <pre>
* JProgressBar bar = new JProgressBar();
* UIDefaults overrides = new UIDefaults();
* overrides.put("ProgressBar.cycleTime", 330);
* ...
* bar.putClientProperty("Nimbus.Overrides", overrides);
* bar.putClientProperty("Nimbus.Overrides.InheritDefaults", false);
* </pre>
* <p>
* Colors in Nimbus are derived from a core set of
* <a href="doc-files/properties.html#primaryColors">primary colors</a>. There
* are also
* <a href="doc-files/properties.html#secondaryColors">secondary colors</a>,
* which are derived from primary ones, but serve themselves as base colors for
* other derived colors. The derivation mechanism allows for runtime
* customization, i.e. if a primary or secondary color is changed, all colors
* that are derived from it are automatically updated. The method
* {@link javax.swing.plaf.nimbus.NimbusLookAndFeel#getDerivedColor(java.lang.String, float, float, float, int, boolean)}
* may be used to create a derived color.
* <p>
* These classes are designed to be used while the corresponding
* {@code LookAndFeel} class has been installed
* (<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
* Using them while a different {@code LookAndFeel} is installed may produce
* unexpected results, including exceptions. Additionally, changing the
* {@code LookAndFeel} maintained by the {@code UIManager} without updating the
* corresponding {@code ComponentUI} of any {@code JComponent}s may also produce
* unexpected results, such as the wrong colors showing up, and is generally not
* encouraged.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.7
* @serial exclude
*/
package javax.swing.plaf.nimbus;

101
jdk/src/java.desktop/share/classes/javax/swing/plaf/nimbus/package.html
View File

@@ -1,101 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides user interface objects built according to the cross-platform
Nimbus look and feel.
<p>Nimbus uses instances of the {@link javax.swing.Painter} interface to paint
components. With each Swing component it associates a foreground and a
background {@code Painter}, and there may be several painters for different
component states.
<p>Nimbus allows customizing many of its properties, including painters, by
altering the {@link javax.swing.UIDefaults} table. Here's an example:
<pre>
UIManager.put("ProgressBar.tileWidth", myTileWidth);
UIManager.put("ProgressBar[Enabled].backgroundPainter", myBgPainter);
UIManager.put("ProgressBar[Enabled].foregroundPainter", myFgPainter);
</pre>
<p>Per-component customization is also possible. When rendering a component,
Nimbus checks its client property named "Nimbus.Overrides". The value of this
property should be an instance of {@code UIDefaults}. Settings from that table
override the UIManager settings, but for that particular component instance
only. An optional client property, "Nimbus.Overrides.InheritDefaults" of type
Boolean, specifies whether the overriding settings should be merged with
default ones ({@code true}), or replace them ({@code false}). By default they
are merged:
<pre>
JProgressBar bar = new JProgressBar();
UIDefaults overrides = new UIDefaults();
overrides.put("ProgressBar.cycleTime", 330);
...
bar.putClientProperty("Nimbus.Overrides", overrides);
bar.putClientProperty("Nimbus.Overrides.InheritDefaults", false);
</pre>
<p>Colors in Nimbus are derived from a core set of
<a href="doc-files/properties.html#primaryColors">primary colors</a>. There are also
<a href="doc-files/properties.html#secondaryColors">secondary colors</a>, which are
derived from primary ones, but serve themselves as base colors for other
derived colors. The derivation mechanism allows for runtime customization,
i.e. if a primary or secondary color is changed, all colors that are derived
from it are automatically updated. The method
{@link javax.swing.plaf.nimbus.NimbusLookAndFeel#getDerivedColor(java.lang.String, float, float, float, int, boolean)}
may be used to create a derived color.
<p>These classes are designed to be used while the
corresponding <code>LookAndFeel</code> class has been
installed
(<code>UIManager.setLookAndFeel(new <i>XXX</i>LookAndFeel())</code>).
Using them while a different <code>LookAndFeel</code> is installed
may produce unexpected results, including exceptions.
Additionally, changing the <code>LookAndFeel</code>
maintained by the <code>UIManager</code> without updating the
corresponding <code>ComponentUI</code> of any
<code>JComponent</code>s may also produce unexpected results,
such as the wrong colors showing up, and is generally not
encouraged.
<p><strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.7
@serial exclude
</body>
</html>

47
jdk/src/java.desktop/share/classes/javax/swing/plaf/package-info.java Normal file
View File

@@ -0,0 +1,47 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides one interface and many abstract classes that Swing uses to provide
* its pluggable look-and-feel capabilities. Its classes are subclassed and
* implemented by look and feel UIs such as Basic and the Java look and feel
* (Metal). This package is only used by developers who cannot create a new
* look and feel by subclassing existing look-and-feel components (such as those
* provided by the {@code javax.swing.plaf.basic} and
* {@code javax.swing.plaf.metal} packages).
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.2
* @serial exclude
*/
package javax.swing.plaf;

57
jdk/src/java.desktop/share/classes/javax/swing/plaf/package.html
View File

@@ -1,57 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides one interface and many abstract classes that
Swing uses to provide its pluggable look-and-feel capabilities. Its
classes are subclassed and implemented by look and feel UIs
such as Basic and the Java look and feel (Metal).
This package is only used by developers who
cannot create a new look and feel by subclassing existing
look-and-feel components (such as those provided
by the <code>javax.swing.plaf.basic</code> and
<code>javax.swing.plaf.metal</code> packages).
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.2
@serial exclude
</body>
</html>

143
jdk/src/java.desktop/share/classes/javax/swing/plaf/synth/package-info.java Normal file
View File

@@ -0,0 +1,143 @@
/*
* Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Synth is a skinnable look and feel in which all painting is delegated. Synth
* does not provide a default look. In order to use Synth you need to specify a
* <a href="doc-files/synthFileFormat.html">file</a>, or provide a
* {@link javax.swing.plaf.synth.SynthStyleFactory}. Both configuration options
* require an understanding of the synth architecture, which is described below,
* as well as an understanding of Swing's architecture.
* <p>
* Unless otherwise specified null is not a legal value to any of the methods
* defined in the synth package and if passed in will result in a
* {@code NullPointerException}.
*
* <h2>Synth</h2>
* Each {@link javax.swing.plaf.ComponentUI} implementation in Synth associates
* itself with one {@link javax.swing.plaf.synth.SynthStyle} per
* {@link javax.swing.plaf.synth.Region}, most {@code Components} only have one
* {@code Region} and therefor only one {@code SynthStyle}. {@code SynthStyle}
* is used to access all style related properties: fonts, colors
* and other {@code Component} properties. In addition {@code SynthStyle}s are
* used to obtain {@link javax.swing.plaf.synth.SynthPainter}s for painting the
* background, border, focus and other portions of a {@code Component}. The
* {@code ComponentUI}s obtain {@code SynthStyle}s from a
* {@link javax.swing.plaf.synth.SynthStyleFactory}. A {@code SynthStyleFactory}
* can be provided directly by way of
* {@link javax.swing.plaf.synth.SynthLookAndFeel#setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory)},
* or indirectly by way of {@link javax.swing.plaf.synth.SynthLookAndFeel#load}.
* The following example uses the {@code SynthLookAndFeel.load()} method to
* configure a {@code SynthLookAndFeel} and sets it as the current look and
* feel:
* <div class="example">
* <pre>{@code
* SynthLookAndFeel laf = new SynthLookAndFeel();
* laf.load(MyClass.class.getResourceAsStream("laf.xml"), MyClass.class);
* UIManager.setLookAndFeel(laf);
* }</pre>
* </div>
* <p>
* Many {@code JComponent}s are broken down into smaller pieces and identified
* by the type safe enumeration in {@link javax.swing.plaf.synth.Region}. For
* example, a {@code JTabbedPane} consists of a {@code Region} for the
* {@code JTabbedPane}({@link javax.swing.plaf.synth.Region#TABBED_PANE}), the
* content area ({@link javax.swing.plaf.synth.Region#TABBED_PANE_CONTENT}), the
* area behind the tabs
* ({@link javax.swing.plaf.synth.Region#TABBED_PANE_TAB_AREA}), and the tabs
* ({@link javax.swing.plaf.synth.Region#TABBED_PANE_TAB}). Each
* {@code Region} of each {@code JComponent} will have a {@code SynthStyle}.
* This allows you to customize individual pieces of each region of each
* {@code JComponent}.
* <p>
* Many of the Synth methods take a {@link javax.swing.plaf.synth.SynthContext}.
* This is used to provide information about the current {@code Component} and
* includes: the {@link javax.swing.plaf.synth.SynthStyle} associated with the
* current {@link javax.swing.plaf.synth.Region}, the state of the
* {@code Component} as a bitmask (refer to
* {@link javax.swing.plaf.synth.SynthConstants} for the valid states), and a
* {@link javax.swing.plaf.synth.Region} identifying the portion of the
* {@code Component} being painted.
* <p>
* All text rendering by non-{@code JTextComponent}s is delegated to a
* {@link javax.swing.plaf.synth.SynthGraphicsUtils}, which is obtained using
* the {@link javax.swing.plaf.synth.SynthStyle} method
* {@link javax.swing.plaf.synth.SynthStyle#getGraphicsUtils}. You can customize
* text rendering by supplying your own
* {@link javax.swing.plaf.synth.SynthGraphicsUtils}.
*
* <h2>Notes on specific components</h2>
* <h3>JTree</h3>
* Synth provides a region for the cells of a tree:
* {@code Region.TREE_CELL}. To specify the colors of the
* renderer you'll want to provide a style for the
* {@code TREE_CELL} region. The following illustrates this:
* <pre>{@code
* <style id="treeCellStyle">
* <opaque value="TRUE"/>
* <state>
* <color value="WHITE" type="TEXT_FOREGROUND"/>
* <color value="RED" type="TEXT_BACKGROUND"/>
* </state>
* <state value="SELECTED">
* <color value="RED" type="TEXT_FOREGROUND"/>
* <color value="WHITE" type="BACKGROUND"/>
* </state>
* </style>
* <bind style="treeCellStyle" type="region" key="TreeCell"/>
* }</pre>
* <p>
* This specifies a color combination of red on white, when selected, and white
* on red when not selected. To see the background you need to specify that
* labels are not opaque. The following XML fragment does that:
* <pre>{@code
* <style id="labelStyle">
* <opaque value="FALSE"/>
* </style>
* <bind style="labelStyle" type="region" key="Label"/>
* }</pre>
*
* <h3>JList and JTable</h3>
* The colors that the renderers for JList and JTable use are specified by way
* of the list and table Regions. The following XML fragment illustrates how to
* specify red on white, when selected, and white on red when not selected:
* <pre>{@code
* <style id="style">
* <opaque value="TRUE"/>
* <state>
* <color value="WHITE" type="TEXT_FOREGROUND"/>
* <color value="RED" type="TEXT_BACKGROUND"/>
* <color value="RED" type="BACKGROUND"/>
* </state>
* <state value="SELECTED">
* <color value="RED" type="TEXT_FOREGROUND"/>
* <color value="WHITE" type="TEXT_BACKGROUND"/>
* </state>
* </style>
* <bind style="style" type="region" key="Table"/>
* <bind style="style" type="region" key="List"/>
* }</pre>
*/
package javax.swing.plaf.synth;

178
jdk/src/java.desktop/share/classes/javax/swing/plaf/synth/package.html
View File

@@ -1,178 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
<p>
Synth is a skinnable look and feel in which all painting is
delegated. Synth does not provide a default look. In
order to use Synth you need to specify a
<a href="doc-files/synthFileFormat.html">file</a>, or
provide a {@link
javax.swing.plaf.synth.SynthStyleFactory}. Both
configuration options require an
understanding of the synth architecture, which is described
below, as well as an understanding of Swing's architecture.
</p>
<p>
Unless otherwise specified null is not a legal value to any of
the methods defined in the synth package and if passed in will
result in a <code>NullPointerException</code>.
<h2>Synth</h2>
<p>
Each {@link javax.swing.plaf.ComponentUI} implementation in Synth associates
itself with one {@link
javax.swing.plaf.synth.SynthStyle} per {@link
javax.swing.plaf.synth.Region}, most
<code>Components</code> only have one <code>Region</code> and
therefor only one <code>SynthStyle</code>.
<code>SynthStyle</code>
is used to access all style related properties: fonts, colors
and other <code>Component</code> properties. In addition
<code>SynthStyle</code>s are used to obtain
{@link javax.swing.plaf.synth.SynthPainter}s for painting the background, border,
focus and other portions of a <code>Component</code>. The <code>ComponentUI</code>s obtain
<code>SynthStyle</code>s from a
{@link javax.swing.plaf.synth.SynthStyleFactory}.
A <code>SynthStyleFactory</code>
can be provided directly by way of
{@link javax.swing.plaf.synth.SynthLookAndFeel#setStyleFactory(javax.swing.plaf.synth.SynthStyleFactory)},
or indirectly by way of
{@link javax.swing.plaf.synth.SynthLookAndFeel#load}. The
following example uses the <code>SynthLookAndFeel.load()</code>
method to configure a <code>SynthLookAndFeel</code> and sets it
as the current look and feel:
</p>
<div class="example">
<pre>
SynthLookAndFeel laf = new SynthLookAndFeel();
laf.load(MyClass.class.getResourceAsStream("laf.xml"), MyClass.class);
UIManager.setLookAndFeel(laf);
</pre>
</div>
<p>
Many <code>JComponent</code>s are broken down into smaller
pieces and identified by the type safe enumeration in
{@link javax.swing.plaf.synth.Region}. For example, a <code>JTabbedPane</code>
consists of a <code>Region</code> for the
<code>JTabbedPane</code> ({@link
javax.swing.plaf.synth.Region#TABBED_PANE}), the content
area ({@link
javax.swing.plaf.synth.Region#TABBED_PANE_CONTENT}), the
area behind the tabs ({@link
javax.swing.plaf.synth.Region#TABBED_PANE_TAB_AREA}), and the
tabs ({@link
javax.swing.plaf.synth.Region#TABBED_PANE_TAB}). Each
<code>Region</code> of each
<code>JComponent</code> will have a
<code>SynthStyle</code>. This allows
you to customize individual pieces of each region of each
<code>JComponent</code>.
<p>
Many of the Synth methods take a {@link javax.swing.plaf.synth.SynthContext}. This
is used to provide information about the current
<code>Component</code> and includes: the
{@link javax.swing.plaf.synth.SynthStyle} associated with the current
{@link javax.swing.plaf.synth.Region}, the state of the <code>Component</code>
as a bitmask (refer to {@link
javax.swing.plaf.synth.SynthConstants} for the valid
states), and a {@link javax.swing.plaf.synth.Region} identifying the portion of
the <code>Component</code> being painted.
<p>
All text rendering by non-<code>JTextComponent</code>s is
delegated to a {@link
javax.swing.plaf.synth.SynthGraphicsUtils}, which is
obtained using the {@link javax.swing.plaf.synth.SynthStyle} method
{@link javax.swing.plaf.synth.SynthStyle#getGraphicsUtils}. You can
customize text rendering
by supplying your own {@link javax.swing.plaf.synth.SynthGraphicsUtils}.
</p>
<h2>Notes on specific components</h2>
<h3>JTree</h3>
<p>
Synth provides a region for the cells of a tree:
<code>Region.TREE_CELL</code>. To specify the colors of the
renderer you'll want to provide a style for the
<code>TREE_CELL</code> region. The following illustrates this:
<pre>
&lt;style id="treeCellStyle">
&lt;opaque value="TRUE"/>
&lt;state>
&lt;color value="WHITE" type="TEXT_FOREGROUND"/>
&lt;color value="RED" type="TEXT_BACKGROUND"/>
&lt;/state>
&lt;state value="SELECTED">
&lt;color value="RED" type="TEXT_FOREGROUND"/>
&lt;color value="WHITE" type="BACKGROUND"/>
&lt;/state>
&lt;/style>
&lt;bind style="treeCellStyle" type="region" key="TreeCell"/>
</pre>
<p>
This specifies a color combination of red on white, when
selected, and white on red when not selected. To see the
background you need to specify that labels are not opaque. The
following XML fragment does that:
<pre>
&lt;style id="labelStyle">
&lt;opaque value="FALSE"/>
&lt;/style>
&lt;bind style="labelStyle" type="region" key="Label"/>
</pre>
<h3>JList and JTable</h3>
<p>
The colors that the renderers for JList and JTable use are
specified by way of the list and table Regions. The following
XML fragment illustrates how to specify red on white, when
selected, and white on red when not selected:
<pre>
&lt;style id="style">
&lt;opaque value="TRUE"/>
&lt;state>
&lt;color value="WHITE" type="TEXT_FOREGROUND"/>
&lt;color value="RED" type="TEXT_BACKGROUND"/>
&lt;color value="RED" type="BACKGROUND"/>
&lt;/state>
&lt;state value="SELECTED">
&lt;color value="RED" type="TEXT_FOREGROUND"/>
&lt;color value="WHITE" type="TEXT_BACKGROUND"/>
&lt;/state>
&lt;/style>
&lt;bind style="style" type="region" key="Table"/>
&lt;bind style="style" type="region" key="List"/>
</pre>
</body>
</html>

55
jdk/src/java.desktop/share/classes/javax/swing/table/package-info.java Normal file
View File

@@ -0,0 +1,55 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides classes and interfaces for dealing with {@code javax.swing.JTable}.
* {@code JTable} is Swing's grid or tabular view for constructing user
* interfaces for tabular data structures inside an application. Use this
* package if you want control over how tables are constructed, updated, and
* rendered, as well as how data associated with the tables are viewed and
* managed.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/table.html"
* target="_top">How to Use Tables</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.table;

66
jdk/src/java.desktop/share/classes/javax/swing/table/package.html
View File

@@ -1,66 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides classes and interfaces for dealing with
<code>javax.swing.JTable</code>.
<code>JTable</code> is Swing's grid or tabular view for
constructing user interfaces for tabular data structures inside
an application. Use this package if you want control over how tables
are constructed, updated, and rendered, as well as how data associated
with the tables are viewed and managed.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/table.html" target="_top">How to Use Tables</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>

49
jdk/src/java.desktop/share/classes/javax/swing/text/html/package-info.java Normal file
View File

@@ -0,0 +1,49 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides the class {@code HTMLEditorKit} and supporting classes for creating
* HTML text editors.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Package Specification</h2>
* <ul>
* <li><a href="http://www.w3.org/TR/REC-html32.html" target="_top">
* HTML 3.2 Reference Specification</a> - The HTML specification on
* which HTMLEditorKit is based.
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.text.html;

59
jdk/src/java.desktop/share/classes/javax/swing/text/html/package.html
View File

@@ -1,59 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides the class <code>HTMLEditorKit</code> and supporting classes
for creating HTML text editors.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Package Specification</h2>
<ul>
<li><a href="http://www.w3.org/TR/REC-html32.html" target="_top">
HTML 3.2 Reference Specification</a> -
The HTML specification on which HTMLEditorKit is based.
</ul>
@since 1.2
@serial exclude
</body>
</html>

44
jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/package-info.java Normal file
View File

@@ -0,0 +1,44 @@
/*
* Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides the default HTML parser, along with support classes. As the stream
* is parsed, the parser notifies a delegate, which must implement the
* {@code HTMLEditorKit.ParserCallback} interface.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @see javax.swing.text.html.HTMLEditorKit.ParserCallback
* @since 1.2
* @serial exclude
*/
package javax.swing.text.html.parser;

54
jdk/src/java.desktop/share/classes/javax/swing/text/html/parser/package.html
View File

@@ -1,54 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides the default HTML parser, along with support classes.
As the stream is parsed,
the parser notifies a delegate,
which must implement
the <code>HTMLEditorKit.ParserCallback</code> interface.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@see javax.swing.text.html.HTMLEditorKit.ParserCallback
@since 1.2
@serial exclude
</body>
</html>

54
jdk/src/java.desktop/share/classes/javax/swing/text/package-info.java Normal file
View File

@@ -0,0 +1,54 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides classes and interfaces that deal with editable and noneditable text
* components. Examples of text components are text fields and text areas, of
* which password fields and document editors are special instantiations.
* Features that are supported by this package include selection/highlighting,
* editing, style, and key mapping.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/text.html"
* target="_top">Using Text Components</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.text;

62
jdk/src/java.desktop/share/classes/javax/swing/text/package.html
View File

@@ -1,62 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides classes and interfaces that deal with editable
and noneditable text components. Examples of text components are text
fields and text areas, of which password fields and document editors
are special instantiations. Features that are supported by this
package include selection/highlighting, editing, style,
and key mapping.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/text.html" target="_top">Using Text Components</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>

42
jdk/src/java.desktop/share/classes/javax/swing/text/rtf/package-info.java Normal file
View File

@@ -0,0 +1,42 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides a class ({@code RTFEditorKit}) for creating Rich-Text-Format text
* editors.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* @since 1.2
* @serial exclude
*/
package javax.swing.text.rtf;

51
jdk/src/java.desktop/share/classes/javax/swing/text/rtf/package.html
View File

@@ -1,51 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides a class (<code>RTFEditorKit</code>) for creating Rich-Text-Format
text editors.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
@since 1.2
@serial exclude
</body>
</html>

53
jdk/src/java.desktop/share/classes/javax/swing/tree/package-info.java Normal file
View File

@@ -0,0 +1,53 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Provides classes and interfaces for dealing with {@code javax.swing.JTree}.
* You use these classes and interfaces if you want control over how trees are
* constructed, updated, and rendered, as well as how data associated with the
* tree nodes are viewed and managed.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/tree.html"
* target="_top">How to Use Trees</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.tree;

62
jdk/src/java.desktop/share/classes/javax/swing/tree/package.html
View File

@@ -1,62 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Provides classes and interfaces for dealing with
<code>javax.swing.JTree</code>. You use these classes and interfaces if you want
control over how trees are constructed, updated, and rendered, as well
as how data associated with the tree nodes are viewed and managed.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/tree.html" target="_top">How to Use Trees</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>

51
jdk/src/java.desktop/share/classes/javax/swing/undo/package-info.java Normal file
View File

@@ -0,0 +1,51 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/**
* Allows developers to provide support for undo/redo in applications such as
* text editors.
* <p>
* <strong>Note:</strong>
* Most of the Swing API is <em>not</em> thread safe. For details, see
* <a
* href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
* target="_top">Concurrency in Swing</a>,
* a section in
* <em><a href="http://docs.oracle.com/javase/tutorial/"
* target="_top">The Java Tutorial</a></em>.
*
* <h2>Related Documentation</h2>
* For overviews, tutorials, examples, guides, and tool documentation,
* please see:
* <ul>
* <li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/generaltext.html#undo"
* target="_top">Implementing Undo and Redo</a>,
* a section in <em>The Java Tutorial</em></li>
* </ul>
*
* @since 1.2
* @serial exclude
*/
package javax.swing.undo;

59
jdk/src/java.desktop/share/classes/javax/swing/undo/package.html
View File

@@ -1,59 +0,0 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<title></title>
</head>
<body bgcolor="white">
Allows developers to provide support for undo/redo
in applications such as text editors.
<p>
<strong>Note:</strong>
Most of the Swing API is <em>not</em> thread safe.
For details, see
<a
href="http://docs.oracle.com/javase/tutorial/uiswing/concurrency/index.html"
target="_top">Concurrency in Swing</a>,
a section in
<em><a href="http://docs.oracle.com/javase/tutorial/"
target="_top">The Java Tutorial</a></em>.
<h2>Related Documentation</h2>
For overviews, tutorials, examples, guides, and tool documentation, please see:
<ul>
<li><a href="http://docs.oracle.com/javase/tutorial/uiswing/components/generaltext.html#undo" target="_top">Implementing Undo and Redo</a>,
a section in <em>The Java Tutorial</em>
</ul>
@since 1.2
@serial exclude
</body>
</html>