Class ExternalWindow
All Packages Class Hierarchy This Package Previous Next Index
Class ExternalWindow
public class netscape.application.ExternalWindow
extends java.lang.Object
implements netscape.application.Window,
netscape.application.ApplicationObserver
{
/* Constructors
*/
public ExternalWindow();
public ExternalWindow(int);
/* Methods
*/
public void addSubview(View);
public void applicationDidPause(Application);
public void applicationDidResume(Application);
public void applicationDidStart(Application);
public void applicationDidStop(Application);
public Rect bounds();
public void center();
public Size contentSize();
protected FoundationDialog createDialog();
protected FoundationFrame createFrame();
protected FoundationPanel createPanel();
public void dispose();
public void hide();
public boolean hidesWhenPaused();
public boolean isResizable();
public boolean isVisible();
public Menu menu();
public Size minSize();
public void moveBy(int, int);
public void moveTo(int, int);
public WindowOwner owner();
public FoundationPanel panel();
public void performCommand(String, Object);
public RootView rootView();
public void setBounds(int, int, int, int);
public void setBounds(Rect);
public void setHidesWhenPaused(boolean);
public void setMenu(Menu);
public void setMinSize(int, int);
public void setOwner(WindowOwner);
public void setResizable(boolean);
public void setTitle(String);
public void show();
public void showModally();
public void sizeBy(int, int);
public void sizeTo(int, int);
public String title();
public View viewForMouse(int, int);
public Size windowSizeForContentSize(int, int);
}
Object subclass providing a platform-dependent window containing IFC
components. Like InternalWindow, it implements the
Window interface. The following code demonstrates the normal sequence for
creating an ExternalWindow:
window = new ExternalWindow();
windowSize = window.windowSizeForContentSize(contentWidth, contentHeight);
window.sizeTo(windowSize.width, windowSize.height);
window.moveTo(x, y);
window.show();
Constructors
ExternalWindow
public ExternalWindow()
- Constructs an ExternalWindow with a style of Window.TITLE_TYPE.
ExternalWindow
public ExternalWindow(int windowType)
- Constructs an ExternalWindow of type windowType. Creates
the platform-dependent (native) window that will hold the
ExternalWindow's contents, as well as the window's RootView
and AWT Panel. The ExternalWindow does not appear onscreen
until it receives a show() message.
Methods
setTitle
public void setTitle(String aTitle)
- Sets the ExternalWindow's title (the string displayed in its title
bar).
title
public String title()
- Returns the ExternalWindow's title.
- See Also:
- setTitle
show
public void show()
- Displays the ExternalWindow.
- See Also:
- hide
showModally
public void showModally()
- Displays the ExternalWindow until dismissed by the user. This method
will not return until the user closes the Window.
hide
public void hide()
- Hides the ExternalWindow.
- See Also:
- show
isVisible
public boolean isVisible()
- Returns true if the ExternalWindow is currently visible
(is onscreen).
dispose
public void dispose()
- Closes the ExternalWindow and destroys the native window.
setMenu
public void setMenu(Menu aMenu)
- Sets the ExternalWindow's Menu.
- See Also:
- Menu
menu
public Menu menu()
- Returns the ExternalWindow's Menu.
- See Also:
- setMenu
rootView
public RootView rootView()
- Returns the RootView that occupies the ExternalWindow.
setOwner
public void setOwner(WindowOwner wOwner)
- Sets the ExternalWindow's owner, the object interested in learning
about special events such as the user closing the ExternalWindow.
owner
public WindowOwner owner()
- Returns the ExternalWindow's owner.
- See Also:
- setOwner
contentSize
public Size contentSize()
- Returns the Size defining the ExternalWindow's content area. Use this
Size to properly position and size any View that you plan to add to the
ExternalWindow.
addSubview
public void addSubview(View aView)
- Adds aView to the ExternalWindow.
setBounds
public void setBounds(int x,
int y,
int width,
int height)
- Sets the Window's bounds to the rectangle (x, y,
width, height). This is the primitive method for
resizing or moving. All the other related methods ultimately call
this one.
setBounds
public void setBounds(Rect newBounds)
- Sets the ExternalWindow's bounds to newBounds.
sizeTo
public void sizeTo(int width,
int height)
- Sets the ExternalWindow's size to (width, height).
sizeBy
public void sizeBy(int deltaWidth,
int deltaHeight)
- Changes the ExternalWindow's size by deltaWidth and
deltaHeight.
moveBy
public void moveBy(int deltaX,
int deltaY)
- Changes the ExternalWindow's location by deltaX and
deltaY.
center
public void center()
- Centers the ExternalWindow (as well as possible for a native window).
moveTo
public void moveTo(int x,
int y)
- Sets the ExternalWindow's origin to (x, y).
windowSizeForContentSize
public Size windowSizeForContentSize(int width,
int height)
- Returns the size the ExternalWindow must be to support a content
size of (width, height).
viewForMouse
public View viewForMouse(int x,
int y)
- Returns the View containing the point (x, y).
setMinSize
public void setMinSize(int width,
int height)
- Sets a minimum size for the ExternalWindow.
Note: The AWT does not appear to support this feature.
minSize
public Size minSize()
- Returns the ExternalWindow's minimum size, if set. Otherwise,
returns null.
bounds
public Rect bounds()
- Returns a newly-allocated copy of the ExternalWindow's bounding
rectangle, which defines the ExternalWindow's size and position.
setResizable
public void setResizable(boolean flag)
- Sets whether the ExternalWindow can be resized by the user.
Throws an error if called when the ExternalWindow is visible.
isResizable
public boolean isResizable()
- Returns true if the user can resize the ExternalWindow.
- See Also:
- setResizable
panel
public FoundationPanel panel()
- Returns the FoundationPanel the ExternalWindow uses to display its
RootView.
createDialog
protected FoundationDialog createDialog()
- Creates and returns the ExternalWindow's FoundationDialog.
This method will be called if the ExternalWindow has a title bar
and is being displayed modally.
ExternalWindow subclasses can override this method to provide a
custom FoundationDialog subclass.
- See Also:
- FoundationFrame
createFrame
protected FoundationFrame createFrame()
- Creates and returns the ExternalWindow's FoundationFrame.
This method will be called if the ExternalWindow has a title bar.
ExternalWindow subclasses can override this method to provide a
custom FoundationFrame subclass.
- See Also:
- FoundationFrame
createPanel
protected FoundationPanel createPanel()
- Creates and returns the ExternalWindow's FoundationPanel.
ExternalWindow subclasses can override this method to provide a
custom FoundationPanel subclass.
- See Also:
- FoundationPanel
applicationDidStart
public void applicationDidStart(Application application)
- ApplicationObserver method.
applicationDidStop
public void applicationDidStop(Application application)
- ApplicationObserver method.
applicationDidPause
public void applicationDidPause(Application application)
- ApplicationObserver method. If hidesWhenPaused() is true
and the ExternalWindow is visible, hides the ExternalWindow.
- See Also:
- setHidesWhenPaused, applicationDidResume
applicationDidResume
public void applicationDidResume(Application application)
- ApplicationObserver method. If hidesWhenPaused() is true
and the ExternalWindow was visible when the Application paused,
makes the ExternalWindow visible.
- See Also:
- setHidesWhenPaused, applicationDidPause
setHidesWhenPaused
public void setHidesWhenPaused(boolean flag)
- Sets whether the ExternalWindow hides when the Application pauses.
If flag is true, the ExternalWindow's
applicationDidPause() method hides the Window if the Window
is visible. The applicationDidResume() brings the Window
back onscreen.
- See Also:
- applicationDidPause, applicationDidResume
hidesWhenPaused
public boolean hidesWhenPaused()
- Returns true if the ExternalWindow hides when the Application
pauses.
- See Also:
- setHidesWhenPaused
performCommand
public void performCommand(String command,
Object data)
- Implements the ExternalWindow's commands:
- SHOW - calls the ExternalWindow's show() method, causing
the ExternalWindow to appear onscreen.
- HIDE - calls the ExternalWindow's hide() method,
removing the ExternalWindow from the screen.
- See Also:
- show, hide
All Packages Class Hierarchy This Package Previous Next Index