1 /*
   2  * Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 /**
  27  * Contains all of the classes for creating user interfaces and for painting
  28  * graphics and images. A user interface object such as a button or a scrollbar
  29  * is called, in AWT terminology, a component. The Component class is the root
  30  * of all AWT components. See Component for a detailed description of properties
  31  * that all AWT components share.
  32  * <p>
  33  * Some components fire events when a user interacts with the components. The
  34  * AWTEvent class and its subclasses are used to represent the events that AWT
  35  * components can fire. See AWTEvent for a description of the AWT event model.
  36  * <p>
  37  * A container is a component that can contain components and other containers.
  38  * A container can also have a layout manager that controls the visual placement
  39  * of components in the container. The AWT package contains several layout
  40  * manager classes and an interface for building your own layout manager. See
  41  * Container and LayoutManager for more information.
  42  * <p>
  43  * Each {@code Component} object is limited in its maximum size and its location
  44  * because the values are stored as an integer. Also, a platform may further
  45  * restrict maximum size and location coordinates. The exact maximum values are
  46  * dependent on the platform. There is no way to change these maximum values,
  47  * either in Java code or in native code. These limitations also impose
  48  * restrictions on component layout. If the bounds of a Component object exceed
  49  * a platform limit, there is no way to properly arrange them within a Container
  50  * object. The object's bounds are defined by any object's coordinate in
  51  * combination with its size on a respective axis.
  52  *
  53  * <h2>Additional Specification</h2>
  54  * <ul>
  55  *     <li><a href="doc-files/FocusSpec.html">The AWT Focus Subsystem</a>
  56  *     <li><a href="doc-files/Modality.html">The AWT Modality</a>
  57  *     <li><a href="{@docRoot}/../specs/AWT_Native_Interface.html">
  58  *                  The Java AWT Native Interface (JAWT)</a>
  59  * </ul>
  60  *
  61  * @since 1.0
  62  */
  63 package java.awt;