<change id="lazymenu.properties">

          <api name="awt"/>

          <summary>Control what client properties pulldown menus have</summary>

          <version major="7" minor="42"/>

          <date day="22" month="11" year="2012"/>

          <author login="jtulach"/>

          <compatibility addition="yes"/>

          <description>

             <p>Layer declaration of a menu can influence what client properties

                 the actual <a href="@JDK@/javax/swing/JMenu.html">JMenu</a> 

                 instances will have. More 

                 <a href="architecture-summary.html#layer-Menu">details</a>.

              </p>

          </description>

          <class package="org.openide.awt" name="MenuBar"/>

          <issue number="222138"/>

      </change>

<li>

    <api name="Menu" group="layer" type="export" category="stable"><p>

        The main menu of the application is composed by reading <code>Menu/</code>

        folder in the layer. A sub folder is treated as a sub menu. 

        Instances of individual files (usually <code>.instance</code> 

        or <code>.shadow</code>) may then represent <a href="@JDK@/javax/swing/Action.html">Action</a>

        or <a href="@JDK@/javax/swing/JMenuItem.html">JMenuItem</a>

        or <a href="@JDK@/javax/swing/JSeparator.html">JSeparator</a>.

    </p>

    <p>

        Since version 7.42 one can attach <code>property-prefix</code> attribute

        to every folder. Then all the file attributes are scanned and if some 

        of them start with the specified prefix they are placed a 

        <a href="@JDK@/javax/swing/JComponent.html#putClientProperty(java.lang.Object,%20java.lang.Object)">

        client

        properties</a> on the <a href="@JDK@/javax/swing/JMenu.html">JMenu</a>

        instance (after stripping the prefix off).

    </p>

    </api><p></p>

</li>

import java.util.Enumeration;

            final FileObject pf = df.getPrimaryFile();

            Object prefix = pf.getAttribute("property-prefix"); // NOI18N

            if (prefix instanceof String) {

                Enumeration<String> en = pf.getAttributes();

                while (en.hasMoreElements()) {

                    String attrName = en.nextElement();

                    if (attrName.startsWith((String)prefix)) {

                        putClientProperty(

                            attrName.substring(((String)prefix).length()), 

                            pf.getAttribute(attrName)

                        );

                    }

                }

            }

import javax.swing.JComponent;

    public void testClientPropertiesMayBePropagated() throws Exception {

        mb.addContainerListener(this);

        assertEquals("No children now", 0, mb.getComponentCount());

        class Atom implements FileSystem.AtomicAction {

            FileObject m1, m2;

            public void run() throws IOException {

                m1 = FileUtil.createFolder(df.getPrimaryFile(), "m1");

                m1.setAttribute("property-prefix", "ahoj.");

                m1.setAttribute("ahoj.jardo", "Hi!");

                m2 = FileUtil.createFolder(df.getPrimaryFile(), "m2");

                m2.setAttribute("property-prefix", "buk-");

                m2.setAttribute("buk-muk", "Hello!");

            }

        }

        Atom atom = new Atom();

        df.getPrimaryFile().getFileSystem().runAtomicAction(atom);

        mb.waitFinished();

        assertEquals("Two children there", 2, mb.getComponentCount());

        final JMenuItem c0 = (JMenuItem) mb.getComponent(0);

        assertEquals("Programatic names deduced from the folder", "m1", c0.getName());

        final JMenuItem c1 = (JMenuItem) mb.getComponent(1);

        assertEquals("Programatic names deduced from the folder", "m2", c1.getName());

        assertEquals("Hi!", c0.getClientProperty("jardo"));

        assertEquals("Hello!", c1.getClientProperty("muk"));

    }