Attachment #116345 for bug #209051

This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

View | Details | Raw Unified | Return to bug 209051
Collapse All | Expand All




<apidef name="winsys">Window System API</apidef>
</apidefs>
<changes>
<change id="topcomponent.subcomponents">
    <api name="winsys"/>
    <summary>Added method TopComponent.getSubComponents.</summary>
    <version major="6" minor="52"/>
    <date day="6" month="3" year="2012"/>
    <author login="saubrecht"/>
    <compatibility addition="yes" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
    <description>
        <p>The new method can be used to access for example inner tabs in a
        multiview window.</p>
    </description>
    <class package="org.openide.windows" name="TopComponent"/>
    <issue number="209051"/>
</change>
<change id="topcomponent.busy">
    <api name="winsys"/>
    <summary>Added method TopComponent.makeBusy(boolean).</summary>

Lines 1-6 Link Here

(-)a/openide.windows/manifest.mf (-1 / +1 lines)
1	Manifest-Version: 1.0	1	Manifest-Version: 1.0
2	OpenIDE-Module: org.openide.windows	2	OpenIDE-Module: org.openide.windows
3	OpenIDE-Module-Specification-Version: 6.51	3	OpenIDE-Module-Specification-Version: 6.52
4	OpenIDE-Module-Localizing-Bundle: org/openide/windows/Bundle.properties	4	OpenIDE-Module-Localizing-Bundle: org/openide/windows/Bundle.properties
5	AutoUpdate-Essential-Module: true	5	AutoUpdate-Essential-Module: true
6		6




import javax.accessibility.Accessible;
import javax.accessibility.AccessibleContext;
import javax.accessibility.AccessibleRole;
import javax.swing.*;
import javax.swing.Action;
import javax.swing.ActionMap;
import javax.swing.JComponent;
import javax.swing.KeyStroke;
import javax.swing.SwingUtilities;
import javax.swing.Timer;
import javax.swing.plaf.basic.BasicHTML;
import javax.swing.text.Keymap;
import org.openide.awt.ActionID;

    public String getHtmlDisplayName() {
        return htmlDisplayName;
    }


    /** Sets toolTip for this <code>TopComponent</code>, adds notification
     * about the change to its <code>WindowManager.TopComponentManager</code>. */

        this.nodeName = nodeName;
    }

    /**
     * Retrieves sub-components this TopComponent contains. The resulting array
     * is a snapshot valid at the time of the call and shouldn't be held for too long.
     * This method can be called from EDT only.
     * 
     * @return Array of internal sub-components or an empty array if the TopComponent
     * has no internal sub-components.
     * @since 6.52
     */
    public SubComponent[] getSubComponents() {
        return new SubComponent[0];
    }

    /** Each top component that wishes to be cloned should implement
    * this interface, so CloneAction can check it and call the cloneComponent
    * method.

        public void removePropertyChangeListener(PropertyChangeListener l);
    }

    /**
     * Representation of a visual sub-component displayed in a TopComponent,
     * for example sub-tabs in a multiview window.
     *
     * @see #getSubComponents()
     * @since 6.52
     */
    public static final class SubComponent {
        private final String displayName;
        private final String description;
        private final boolean active;
        private final ActionListener activator;

        /**
         * C'tor
         * @param displayName Subcomponent's display name.
         * @param activator ActionListener to invoke when the sub-component needs
         * to be actived.
         * @param active True if the given sub-component is currently active,
         * e.g. multiview sub-tab is selected.
         */
        public SubComponent( String displayName, ActionListener activator, boolean active ) {
            this( displayName, null, activator, active );
        }

        /**
         * C'tor
         * @param displayName Subcomponent's display name.
         * @param description Short description to show in a tooltip.
         * @param activator ActionListener to invoke when the sub-component needs
         * to be actived.
         * @param active True if the given sub-component is currently active,
         * e.g. multiview sub-tab is selected.
         */
        public SubComponent( String displayName, String description, ActionListener activator, boolean active ) {
            this.displayName = displayName;
            this.description = description;
            this.active = active;
            this.activator = activator;
        }

        /**
         * @return True if this sub-component is the active/selected one.
         */
        public final boolean isActive() {
            return active;
        }

        public final String getDescription() {
            return description;
        }

        public final String getDisplayName() {
            return displayName;
        }

        /**
         * Make this sub-component the active/selected one.
         */
        public final void activate() {
            activator.actionPerformed( new ActionEvent( this, 0, "activate") ); //NOI18N
        }
    }

    private class AttentionGetter implements ActionListener {
        Timer timer = null;


Return to bug 209051

Lines 80-92 Link Here

(-)a/openide.windows/src/org/openide/windows/TopComponent.java (-8 / +79 lines)
80	import javax.accessibility.Accessible;	80	import javax.accessibility.Accessible;
81	import javax.accessibility.AccessibleContext;	81	import javax.accessibility.AccessibleContext;
82	import javax.accessibility.AccessibleRole;	82	import javax.accessibility.AccessibleRole;
83	import javax.swing.AbstractAction;	83	import javax.swing.*;
84	import javax.swing.Action;
85	import javax.swing.ActionMap;
86	import javax.swing.JComponent;
87	import javax.swing.KeyStroke;
88	import javax.swing.SwingUtilities;
89	import javax.swing.Timer;
90	import javax.swing.plaf.basic.BasicHTML;	84	import javax.swing.plaf.basic.BasicHTML;
91	import javax.swing.text.Keymap;	85	import javax.swing.text.Keymap;
92	import org.openide.awt.ActionID;	86	import org.openide.awt.ActionID;
Lines 1033-1039 Link Here
1033	public String getHtmlDisplayName() {	1027	public String getHtmlDisplayName() {
1034	return htmlDisplayName;	1028	return htmlDisplayName;
1035	}	1029	}
1036		1030
1037		1031
1038	/** Sets toolTip for this <code>TopComponent</code>, adds notification	1032	/** Sets toolTip for this <code>TopComponent</code>, adds notification
1039	* about the change to its <code>WindowManager.TopComponentManager</code>. */	1033	* about the change to its <code>WindowManager.TopComponentManager</code>. */
Lines 1394-1399 Link Here
1394	this.nodeName = nodeName;	1388	this.nodeName = nodeName;
1395	}	1389	}
1396		1390
		1391	/**
		1392	* Retrieves sub-components this TopComponent contains. The resulting array
		1393	* is a snapshot valid at the time of the call and shouldn't be held for too long.
		1394	* This method can be called from EDT only.
		1395	*
		1396	* @return Array of internal sub-components or an empty array if the TopComponent
		1397	* has no internal sub-components.
		1398	* @since 6.52
		1399	*/
		1400	public SubComponent[] getSubComponents() {
		1401	return new SubComponent[0];
		1402	}
		1403
1397	/** Each top component that wishes to be cloned should implement	1404	/** Each top component that wishes to be cloned should implement
1398	* this interface, so CloneAction can check it and call the cloneComponent	1405	* this interface, so CloneAction can check it and call the cloneComponent
1399	* method.	1406	* method.
Lines 1539-1544 Link Here
1539	public void removePropertyChangeListener(PropertyChangeListener l);	1546	public void removePropertyChangeListener(PropertyChangeListener l);
1540	}	1547	}
1541		1548
		1549	/**
		1550	* Representation of a visual sub-component displayed in a TopComponent,
		1551	* for example sub-tabs in a multiview window.
		1552	*
		1553	* @see #getSubComponents()
		1554	* @since 6.52
		1555	*/
		1556	public static final class SubComponent {
		1557	private final String displayName;
		1558	private final String description;
		1559	private final boolean active;
		1560	private final ActionListener activator;
		1561
		1562	/**
		1563	* C'tor
		1564	* @param displayName Subcomponent's display name.
		1565	* @param activator ActionListener to invoke when the sub-component needs
		1566	* to be actived.
		1567	* @param active True if the given sub-component is currently active,
		1568	* e.g. multiview sub-tab is selected.
		1569	*/
		1570	public SubComponent( String displayName, ActionListener activator, boolean active ) {
		1571	this( displayName, null, activator, active );
		1572	}
		1573
		1574	/**
		1575	* C'tor
		1576	* @param displayName Subcomponent's display name.
		1577	* @param description Short description to show in a tooltip.
		1578	* @param activator ActionListener to invoke when the sub-component needs
		1579	* to be actived.
		1580	* @param active True if the given sub-component is currently active,
		1581	* e.g. multiview sub-tab is selected.
		1582	*/
		1583	public SubComponent( String displayName, String description, ActionListener activator, boolean active ) {
		1584	this.displayName = displayName;
		1585	this.description = description;
		1586	this.active = active;
		1587	this.activator = activator;
		1588	}
		1589
		1590	/**
		1591	* @return True if this sub-component is the active/selected one.
		1592	*/
		1593	public final boolean isActive() {
		1594	return active;
		1595	}
		1596
		1597	public final String getDescription() {
		1598	return description;
		1599	}
		1600
		1601	public final String getDisplayName() {
		1602	return displayName;
		1603	}
		1604
		1605	/**
		1606	* Make this sub-component the active/selected one.
		1607	*/
		1608	public final void activate() {
		1609	activator.actionPerformed( new ActionEvent( this, 0, "activate") ); //NOI18N
		1610	}
		1611	}
		1612
1542	private class AttentionGetter implements ActionListener {	1613	private class AttentionGetter implements ActionListener {
1543	Timer timer = null;	1614	Timer timer = null;
1544		1615

Lines 50-55 Link Here

(-)a/openide.windows/apichanges.xml (+14 lines)
50	<apidef name="winsys">Window System API</apidef>	50	<apidef name="winsys">Window System API</apidef>
51	</apidefs>	51	</apidefs>
52	<changes>	52	<changes>
		53	<change id="topcomponent.subcomponents">
		54	<api name="winsys"/>
		55	<summary>Added method TopComponent.getSubComponents.</summary>
		56	<version major="6" minor="52"/>
		57	<date day="6" month="3" year="2012"/>
		58	<author login="saubrecht"/>
		59	<compatibility addition="yes" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
		60	<description>
		61	<p>The new method can be used to access for example inner tabs in a
		62	multiview window.</p>
		63	</description>
		64	<class package="org.openide.windows" name="TopComponent"/>
		65	<issue number="209051"/>
		66	</change>
53	<change id="topcomponent.busy">	67	<change id="topcomponent.busy">
54	<api name="winsys"/>	68	<api name="winsys"/>
55	<summary>Added method TopComponent.makeBusy(boolean).</summary>	69	<summary>Added method TopComponent.makeBusy(boolean).</summary>