-
Notifications
You must be signed in to change notification settings - Fork 1
DevFaqWindowsTopComponent
[http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/TopComponent.html org.openide.windows.TopComponent] is a JComponent subclass which knows how to work with
the NetBeans window system. If you want to add components to the main window, typically you will subclass TopComponent, using it the same way you would a JPanel.
TopComponents live inside Modes - docking containers.
TopComponents can have various states:
-
open/closed - When a TopComponent is open, a tab exists somewhere in the main window or UI for it
-
visible/invisible - When a TopComponent is visible, it is the selected tab in its Mode
-
active/inactive - When a TopComponent is active, it or a child component of it has keyboard focus, and it is currently the global selection context
Each TopComponent has a Lookup and one or more `activated Node`s. These define the selection context for the window system, which determines what actions (menu items, toolbar buttons, etc.) are enabled, and in some cases, what they will do or operate on if invoked.
`TopComponent`s are part of the Windows API.
TopComponents that were already open may be deserialized and reopened on restart. The template that NetBeans 5.0 provides includes code for this - it is actually using saved using the Externalizable interface. Whether or not it is saved is determined by what you return from getPersistenceType().
For information on how and when these are reconstructed on startup, see the gory details of the window system on startup.
The content in this page was kindly donated by Oracle Corp. to the Apache Software Foundation.
This page was exported from http://wiki.netbeans.org/DevFaqWindowsTopComponent , that was last modified by NetBeans user Tboudreau on 2010-02-25T16:18:58Z.
NOTE: This document was automatically converted to the AsciiDoc format on 2018-01-26, and needs to be reviewed.
Apache NetBeans is an effort undergoing incubation at The Apache Software Foundation (ASF).
Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects.
While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
This wiki is an experiment pending Apache NetBeans Community approval.