<doc>
  <legacy_id>1630</legacy_id>
  <name>menubar</name>
  <type>property</type>
  <syntax>
    <example>set the menubar of <i>stack</i> to {<i>groupname</i> | empty}</example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Menus</category>
  </classification>
  <references>
    <function tag="menus">menus Function</function>
    <property tag="raiseMenus">raiseMenus Property</property>
    <property tag="menuName">menuName Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies the name of a <glossary tag="menu bar">menu bar</glossary> to use when a <object tag="stack">stack</object> is frontmost.</summary>
  <examples>
    <example>set the menubar of this stack to "Menus"</example>
  </examples>
  <description>
    <p>Use the <b>menubar</b> <glossary tag="property">property</glossary> to specify which <function tag="menus">menus</function> appear in the <glossary tag="menu bar">menu bar</glossary> on <glossary tag="Mac OS">Mac OS systems</glossary> when a <object tag="stack">stack</object> is the <glossary tag="active window">active window</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>menubar</b> of a <object tag="stack">stack</object> is the name of a <command tag="group">group</command>.</p><p/><p>By default, the <b>menubar</b> of newly created <function tag="stacks">stacks</function> is set to empty.</p><p/><p><b>Comments:</b></p><p>On Mac OS systems, the menu bar appears at the top of the screen. On Unix and Windows systems, the menu bar appears at the top of the stack window. (LiveCode menus are created with buttons. Each menu is a button whose <b>menuMode</b> <glossary tag="property">property</glossary> is set to "pulldown"; these <glossary tag="button">buttons</glossary> are then grouped to form a <glossary tag="menu bar">menu bar</glossary>.)</p><p/><p>The <b>menubar</b> is the <command tag="group">group</command> that contains the <glossary tag="button">buttons</glossary> used to build the <glossary tag="menu bar">menu bar</glossary>. This <glossary tag="menu bar">menu bar</glossary> is used when the <glossary tag="stack window">stack window</glossary> is active, replacing the <property tag="defaultMenubar">defaultMenubar</property>. If the <b>menubar</b> of a <object tag="stack">stack</object> is empty, the <object tag="stack">stack</object> does not have its own custom <glossary tag="menu bar">menu bar</glossary>, and the <property tag="defaultMenubar">defaultMenubar</property> is used when the <object tag="stack">stack</object> is active.</p><p/><p>On Mac OS systems, when a stack's <b>menubar</b> <glossary tag="property">property</glossary> is set, the <object tag="stack">stack</object> is scrolled and resized on <glossary tag="Mac OS">Mac OS systems</glossary> so that the <command tag="group">group</command> is not visible in the <glossary tag="stack window">stack window</glossary>. (On <glossary tag="Unix">Unix</glossary> and <glossary tag="Windows">Windows systems</glossary>, this is not necessary, since the <glossary tag="menu bar">menu bar</glossary> is normally displayed in the window.) To scroll the <glossary tag="stack window">stack window</glossary> back down so you can see and select the <glossary tag="group">group's</glossary> <glossary tag="object">objects</glossary>, set the <property tag="editMenus">editMenus</property> <glossary tag="property">property</glossary> to true.</p>
  </description>
</doc>