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;