Class Popup
All Packages Class Hierarchy This Package Previous Next Index
Class Popup
public class netscape.application.Popup
extends netscape.application.View
implements netscape.application.Target
{
/* Constructors
*/
public Popup();
public Popup(Rect);
public Popup(int, int, int, int);
/* Methods
*/
public ListItem addItem(String, String);
public Border border();
public String command();
public int count();
public void decode(Decoder);
public void describeClassInfo(ClassInfo);
public void drawView(Graphics);
public void encode(Encoder);
public boolean isTransparent();
public ListItem itemAt(int);
protected void layoutPopupWindow();
public boolean mouseDown(MouseEvent);
public void performCommand(String, Object);
public Image popupImage();
public ListView popupList();
public Window popupWindow();
public ListItem prototypeItem();
public void removeAllItems();
public void removeItem(String);
public void selectItem(ListItem);
public void selectItemAt(int);
public int selectedIndex();
public ListItem selectedItem();
public void sendCommand();
public void setBorder(Border);
public void setCommand(String);
public void setPopupImage(Image);
public void setPopupList(ListView);
public void setPopupWindow(Window);
public void setPrototypeItem(ListItem);
public void setTarget(Target);
protected void showPopupWindow(MouseEvent);
public Target target();
}
View subclass that, when clicked, pops up a window containing a ListView
of PopupItems. When the user selects a PopupItem, the Popup sends the
PopupItem's command to the Popup's target. By default, the Popup creates
and displays PopupItems, but you can create and use your own ListItem
subclass.
- See Also:
- PopupItem, ListView
Constructors
Popup
public Popup()
- Constructs an empty Popup.
Popup
public Popup(Rect rect)
- Constructs an empty Popup with bounds rect. This Rect
defines the bounds of the inactive (not popped-up) Popup. When active,
the Popup grows vertically to fully display its items.
Popup
public Popup(int x,
int y,
int width,
int height)
- Constructs an empty Popup with the given bounds. This rectangle
defines the bounds of the inactive (not popped-up) Popup. When active,
the Popup grows vertically to fully display its items.
Methods
setPrototypeItem
public void setPrototypeItem(ListItem item)
- Sets the prototype ListItem used by the Popup's ListView.
prototypeItem
public ListItem prototypeItem()
- Returns the prototype ListItem used by the Popup's ListView.
- See Also:
- setPrototypeItem
removeAllItems
public void removeAllItems()
- Removes all ListItems from the Popup.
addItem
public ListItem addItem(String title,
String command)
- Adds a ListItem with the given title and command to the Popup. Calls
addItem() on the Popup's ListView.
- See Also:
- addItem
removeItem
public void removeItem(String title)
- Removes the ListItem with title title from the Popup.
selectedIndex
public int selectedIndex()
- Returns the index of the Popup's selected row.
selectedItem
public ListItem selectedItem()
- Returns the Popup's selected ListItem.
selectItem
public void selectItem(ListItem item)
- Selects a particular Popup item. When inactive, the Popup displays
the currently selected ListItem.
selectItemAt
public void selectItemAt(int index)
- Calls selectItem() using the ListItem at the given row.
count
public int count()
- Returns the number of ListItems the Popup contains.
itemAt
public ListItem itemAt(int index)
- Returns the ListItem at the given row index.
setBorder
public void setBorder(Border aBorder)
- Sets the Popup's Border. The Popup draws this Border around its
smaller inactive state and around its window when active. You can
customize a Popup's look by setting a different Border.
border
public Border border()
- Returns the Popup's border.
- See Also:
- setBorder
setPopupList
public void setPopupList(ListView list)
- Sets the ListView the Popup should use to maintain its ListItems.
You can customize a Popup's look by providing a custom ListView.
popupList
public ListView popupList()
- Returns the Popup's ListView.
- See Also:
- setPopupList
setPopupWindow
public void setPopupWindow(Window window)
- Sets the Window used to contain the active Popup. You can change the
active Popup's appearance by providing a custom Window.
popupWindow
public Window popupWindow()
- Returns the active Popup's Window.
- See Also:
- setPopupWindow
setPopupImage
public void setPopupImage(Image anImage)
- Sets the Image displayed by the selected ListItem.
popupImage
public Image popupImage()
- Returns the Image displayed by the selected ListItem.
- See Also:
- setPopupImage
layoutPopupWindow
protected void layoutPopupWindow()
- Sizes and positions the Popup's Window to accomodate its ListItems, and
positions the Popup's ListView within its Window. Popup calls this
method before bringing its Window onscreen.
showPopupWindow
protected void showPopupWindow(MouseEvent event)
- Brings the Popup's Window onscreen. Popup calls this method after
calling layoutPopupWindow(), in response to a mouse down event
on the Popup's inactive state. This method actually pops up the Popup.
mouseDown
public boolean mouseDown(MouseEvent event)
- Catches mouse events on the Popup's inactive "button". Calls
layoutPopupWindow() followed by showPopupWindow().
- Overrides:
- mouseDown in class View
isTransparent
public boolean isTransparent()
- Returns true if the Popup is transparent. A Popup is
transparent if its ListView is transparent.
- Overrides:
- isTransparent in class View
- See Also:
- popupList
drawView
public void drawView(Graphics g)
- Draws the inactive Popup.
- Overrides:
- drawView in class View
setTarget
public void setTarget(Target newTarget)
- Sets the Popup's Target. The Popup sends its command to its Target when
the currently selected ListItem changes.
target
public Target target()
- Returns the Popup's Target.
- See Also:
- setTarget
setCommand
public void setCommand(String newCommand)
- Sets the Popup's command. The Popup sends this command to its Target
if the selected ListItem does not have a command.
command
public String command()
- Returns the Popup's command.
- See Also:
- setCommand
sendCommand
public void sendCommand()
- Sends a command to the Popup's Target. This command is either the
selected ListItem's command, or the Popup's command (if the ListItem
has no command).
performCommand
public void performCommand(String command,
Object data)
- Responds to a message from its ListView that the user has selected a
different ListItem. Calls sendCommand() and hides the
Popup Window.
describeClassInfo
public void describeClassInfo(ClassInfo info)
- Describes the Popup class' information.
- Overrides:
- describeClassInfo in class View
- See Also:
- describeClassInfo
encode
public void encode(Encoder encoder) throws CodingException
- Archives the Popup instance.
- Overrides:
- encode in class View
- See Also:
- encode
decode
public void decode(Decoder decoder) throws CodingException
- Unarchives the Popup instance.
- Overrides:
- decode in class View
- See Also:
- decode
All Packages Class Hierarchy This Package Previous Next Index