ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakx_5.4.0.1/rzakxdescquerycntxtmenu.htm

77 lines
5.8 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Description of QueryContextMenu flags" />
<meta name="abstract" content="Add SHORT DESCRIPTION." />
<meta name="description" content="Add SHORT DESCRIPTION." />
<meta name="DC.Relation" scheme="URI" content="rzakxproperty.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakxproperty.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakxdescquerycntxtmenu" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Description of QueryContextMenu flags</title>
</head>
<body id="rzakxdescquerycntxtmenu"><a name="rzakxdescquerycntxtmenu"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Description of QueryContextMenu flags</h1>
<div><p>Add SHORT DESCRIPTION.</p>
<p>iSeries™ Navigator supports the following enhancements to the IContextMenu interface:</p>
<dl><dt class="dlterm">Ordering of context menu items</dt>
<dd>The iSeries Navigator has extended the IContextMenu interface to obtain more precise control over the order in which
menu items are added to the menu for a particular folder or object. The Navigator structures its context menus in three sections. This structure ensures that when more than one component adds items to the
context menu for an object, the items will still appear in the correct order that is defined for the Windows<sup>®</sup> user
interface. <p>The first section contains actions which are specific to the object type, such as Reorganize for a database table. The second section contains "object creation" items; these items are object
types which cascade off of a New menu item. Lastly there are the so-called "standard" Windows menu
items, such as Delete or Properties. You may choose to add menu items to any section of the context menu.</p>
<p>The iSeries Navigator
calls the QueryContextMenu method for a component three times in succession, once for each section of the menu. The following additional flags are defined in the uFlags parameter to allow you to determine
which section of the context menu is currently being serviced.</p>
<dl><dt class="dlterm">UNITY_CMF_CUSTOM</dt>
<dd>This flag indicates that you should add object-specific actions to the menu.</dd>
<dt class="dlterm">UNITY_CMF_NEW</dt>
<dd>This flag indicates that you should add object creation items to the menu.</dd>
<dt class="dlterm">UNITY_CMF_STANDARD</dt>
<dd>This flag indicates that you should add standard actions to the menu.</dd>
<dt class="dlterm">UNITY_CMF_FILEMENU</dt>
<dd> <p>This flag changes UNITY_CMF_STANDARD. It indicates construction of the File menu pull down for your object, as opposed to the menu that is displayed when the user clicks on an object with mouse
button 2.</p>
<p>Items on the File pull down are arranged slightly differently. If you add Properties to the menu, you should avoid inserting a separator as is normally done before this item. Also, edit
actions such as Copy or Paste should not be added to the File menu, because they appear on the Edit pull down instead. (The iSeries Navigator
calls your shell plug-in at the appropriate time to obtain the items for the Edit menu, and does not set UNITY_CMF_FILEMENU).</p>
</dd>
</dl>
</dd>
</dl>
<dl><dt class="dlterm">Unique property dialogs</dt>
<dd> <p>In certain cases, a plug-in may desire to implement a Properties context menu item that is defined for one of its own object types as a standard Windows dialog instead of a property sheet. A flag that is defined for this situation may be returned to the Navigator on calls to IContextMenu::QueryContextMenu when
the UNITY_CMF_STANDARD flag is set. This flag, A4HYF_INFO_PROPERTIESADDED, should be OR'd with the HRESULT value that is returned by QueryContextMenu.</p>
<p>Returning this flag means that automatic processing
for Properties is not performed. In this case, the plug-in must add the context menu item and construct the associated dialog.</p>
</dd>
</dl>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxproperty.htm" title="The Microsoft Foundation Class Library classes cannot be used to construct property pages for a property sheet handler. However, IBM provides CExtPropertyPage, which may be used in place of the MFC class CPropertyPage.">Property pages for a property sheet handler</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzakxproperty.htm" title="The Microsoft Foundation Class Library classes cannot be used to construct property pages for a property sheet handler. However, IBM provides CExtPropertyPage, which may be used in place of the MFC class CPropertyPage.">Property pages for a property sheet handler</a></div>
</div>
</div>
</body>
</html>