68 lines
6.6 KiB
HTML
68 lines
6.6 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="iSeries Navigator structure and flow of control for Visual Basic plug-ins" />
|
||
|
|
<meta name="abstract" content="For Visual Basic plug-ins, iSeries Navigator provides a built-in ActiveX server that manages the communication between Navigator and the plug-in's implementation." />
|
||
|
|
<meta name="description" content="For Visual Basic plug-ins, iSeries Navigator provides a built-in ActiveX server that manages the communication between Navigator and the plug-in's implementation." />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxpluginvb.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxopnavlistmanagerclassvb.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxopnavactionsmanagerclassvb.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakxopnavdroptargetmanagerclassvb.htm" />
|
||
|
|
<meta name="DC.Format" content="XHTML" />
|
||
|
|
<meta name="DC.Identifier" content="rzakxvbcntrolflow" />
|
||
|
|
<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>iSeries Navigator structure and flow of control for Visual Basic plug-ins</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakxvbcntrolflow"><a name="rzakxvbcntrolflow"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">iSeries Navigator structure and flow of control for Visual Basic plug-ins</h1>
|
||
|
|
<div><p>For Visual Basic plug-ins, iSeries™ Navigator provides a built-in ActiveX server that manages the communication
|
||
|
|
between Navigator and the plug-in's implementation.</p>
|
||
|
|
<p>Visual Basic programmers who are developing iSeries Navigator plug-ins then use the facilities that are provided by Microsoft<sup>®</sup>'s Visual Basic 5.0 to create their plug-in classes, and to package them in an ActiveX server DLL.</p>
|
||
|
|
<p>Plug-ins work by responding to method calls from iSeries Navigator that are generated in response to user actions. For
|
||
|
|
example, when a user right-clicks on an object in the Navigator hierarchy, Navigator constructs a context menu for the object and displays the menu on the screen. Navigator obtains the menu items by calling
|
||
|
|
each plug-in that has registered its intent to supply context menu items for the selected object type.</p>
|
||
|
|
<p>The functions that are implemented by a plug-in are logically grouped into <span class="uicontrol">interfaces</span>. An interface is a set of logically related methods on a class that iSeries Navigator can call to perform a specific function. For Visual Basic plug-ins, three interfaces are defined:</p>
|
||
|
|
<ul><li>ListManager</li>
|
||
|
|
<li>ActionsManager</li>
|
||
|
|
<li>DropTargetManager</li>
|
||
|
|
</ul>
|
||
|
|
<div class="section"><h4 class="sectiontitle">iSeries Navigator data for Visual Basic plug-ins</h4><p>When the Navigator calls a function implemented
|
||
|
|
by a plug-in, the request typically involves an object or objects the user selected in the main Navigator window. The plug-in must be able to determine which objects have been selected. The plug-in receives
|
||
|
|
this information as a list of fully-qualified object names. For Visual Basic plug-ins, an ObjectName class is defined that provides information about the selected objects. Plug-ins that add folders to the
|
||
|
|
object hierarchy must return items in the folder to iSeries Navigator in the form of "item identifiers." For Visual Basic
|
||
|
|
plug-ins, an ItemIdentifier class is defined that is used by the plug-in to return the requested information.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">iSeries Navigator services for Visual Basic plug-ins</h4><p>An iSeries Navigator plug-in sometimes will need to affect the behavior of the main Navigator window. For example, following completion of a user operation, it may be necessary
|
||
|
|
to refresh the Navigator list view or to insert text into the Navigator's status area. A utility class called UIServices is supplied in the Visual Basic environment that provides the required services.
|
||
|
|
A Visual Basic plug-in also can use the C++ APIs in the cwbun.h header file to achieve similar results. For detailed descriptions of this class and its methods, see the online help that is provided with
|
||
|
|
the iSeries Navigator Visual Basic Plug-in Support DLL (cwbunvbi.dll and cwbunvbi.hlp).</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxpluginvb.htm" title="Use the following topics to learn about the flow of control in iSeries Navigator for Visual Basic.">Visual Basic Reference</a></div>
|
||
|
|
</div>
|
||
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
||
|
|
<div><a href="rzakxopnavlistmanagerclassvb.htm" title="The ListManager interface class is used for data serving in iSeries Navigator. For example, when a list view needs to be created and filled with objects, iSeries Navigator will call methods in the ListManager class to do this.">iSeries Navigator ListManager interface class</a></div>
|
||
|
|
<div><a href="rzakxopnavactionsmanagerclassvb.htm" title="The ActionsManager interface class is used to build context menus, and to implement commands of the context menu actions. For example, when a user performs a right mouse-click on a Visual Basic list object in iSeries Navigator, the queryActions method in the ActionsManager interface class will be called to return the context menu item strings.">iSeries Navigator ActionsManager interface class</a></div>
|
||
|
|
<div><a href="rzakxopnavdroptargetmanagerclassvb.htm" title="The DropTargetManager interface class is used to handle drag-and-drop operations in iSeries Navigator.">iSeries Navigator DropTargetManager interface class</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|