77 lines
5.8 KiB
HTML
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>
|