org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-6359AD9D-2D02-4265-8B47-AF18713AB726.html
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="mobileconcept"/><meta name="DC.Title" content="getMenuItemByName()"/><meta name="DC.Relation" scheme="URI" content="GUID-5610C4B8-8988-4895-8F88-36F444B4ACFC"/><meta name="DC.Relation" scheme="URI" content="GUID-860D488F-98AA-4EF2-BDEC-8400A642CBD6"/><meta name="DC.Relation" scheme="URI" content="GUID-7C69DDA4-16F1-4A8F-BDB2-4CB0015B4E81"/><meta name="DC.Relation" scheme="URI" content="GUID-857CF71D-3398-40C2-981A-DEC428A7BA6B"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-6359AD9D-2D02-4265-8B47-AF18713AB726"/><title>getMenuItemByName() </title><script type="text/javascript">
function initPage() {}
</script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-6359AD9D-2D02-4265-8B47-AF18713AB726">getMenuItemByName()</h1><div>
<p><strong>Description:</strong></p>
<p>Call the <code>getMenuItemByName</code> method with a specified
menu item's label to retrieve the handle of the menu item instance.</p>
<p>For more general information on creating an options menu, see <a href="GUID-94946735-D23B-49C6-BB65-8BE31737AE42.html#GUID-94946735-D23B-49C6-BB65-8BE31737AE42">Using softkeys</a>.</p>
<p><strong>Syntax:</strong></p>
<pre class="codeblock" id="GUID-CD53F143-A473-48BD-B707-12D00CEDF3C4">[<a href="GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D.html#GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D">MenuItem</a>] window.menu.getMenuItemByName(String menuItemLabel) </pre>
<p>or</p>
<pre class="codeblock" id="GUID-48F19335-C8ED-42A2-98AE-1A984699C088">[<a href="GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D.html#GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D">MenuItem</a>] menu.getMenuItemByName(String menuItemLabel)</pre>
<p><strong>Arguments:</strong></p>
<ul>
<li><p><code>menuItemLabel</code>:</p>
<p>This is the label of an existing <a href="GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D.html#GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D">menu
item</a> whose handle is being retrieved.</p>
</li>
</ul>
<p><strong>Return value:</strong></p>
<p>The returned value is an instance of the existing <a href="GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D.html#GUID-111DE423-9C84-4E4B-A45E-15081FE2A30D"><code>MenuItem</code></a> object. If the label is invalid, the method returns "undefined".</p>
<p><strong>Example code:</strong></p>
<p>See the example code in the description of the <a href="GUID-A022ED1B-E618-4C44-A437-78393900599C.html#GUID-A022ED1B-E618-4C44-A437-78393900599C"><code>MenuItem.onSelect</code></a> property.</p>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>