/*
*
*
* Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
*
* This program 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.
*
* This program 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 at /legal/license.txt).
*
* 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 Sun Microsystems, Inc., 4150 Network Circle, Santa
* Clara, CA 95054 or visit www.sun.com if you need additional
* information or have any questions.
*/
package javax.microedition.lcdui;
/**
* The common superclass of all high-level user interface classes. The
* contents displayed and their interaction with the user are defined by
* subclasses.
*
* <P>Using subclass-defined methods, the application may change the contents
* of a <code>Screen</code> object while it is shown to the user. If
* this occurs, and the
* <code>Screen</code> object is visible, the display will be updated
* automatically. That
* is, the implementation will refresh the display in a timely fashion without
* waiting for any further action by the application. For example, suppose a
* <code>List</code> object is currently displayed, and every element
* of the <code>List</code> is
* visible. If the application inserts a new element at the beginning of the
* <code>List</code>, it is displayed immediately, and the other
* elements will be
* rearranged appropriately. There is no need for the application to call
* another method to refresh the display.</P>
*
* <P>It is recommended that applications change the contents of a
* <code>Screen</code> only
* while it is not visible (that is, while another
* <code>Displayable</code> is current).
* Changing the contents of a <code>Screen</code> while it is visible
* may result in
* performance problems on some devices, and it may also be confusing if the
* <code>Screen's</code> contents changes while the user is
* interacting with it.</P>
*
* <P>In MIDP the four <code>Screen</code> methods that defined
* read/write ticker and
* title properties were moved to <code>Displayable</code>,
* <code>Screen's</code> superclass. The
* semantics of these methods have not changed.</P>
*
* @since MIDP 1.0
*/
public abstract class Screen extends Displayable {
/**
* Creates a new Screen object with the given title and with no ticker.
*
* @param title the Screen's title, or null for no title
*/
Screen(String title) {
super(title);
}
}
|