DiagramLauncher Control

Last modified: October 13, 2010

Applies to: SharePoint Foundation 2010

An ActiveX control that enables a Microsoft SharePoint Foundation user to create a Microsoft Visio 2010 diagram from a list if Visio 2010 is installed on the client computer.

This control is defined in DGRMLNCH.dll, a dynamic-link library (DLL) that is installed in the %ProgramFiles%\Microsoft Office\Office14\ directory on the client computer when Visio 2010 is installed.

To instantiate this control, use the following function in ECMAScript (JavaScript, JScript):

var obj = new ActiveXObject('DiagramLaunch.DiagramLauncher');

In Microsoft Visual Basic Scripting Edition (VBScript), use the following to instantiate the control:

Set obj = CreateObject('DiagramLaunch.DiagramLauncher')

In both cases, the argument is the ProgId of the control, DiagramLaunch.DiagramLauncher. For more information about ProgIds, see <ProgID> Key.

In SharePoint Foundation, when a user clicks Create Visio Diagram on the List Tools ribbon on a page that contains a list, the ExportDiagram function in OWS.js is called. This function creates the control and uses the control to export a diagram.

You can create a custom control for creating a diagram from a list if it has the same ProgID (DiagramLaunch.DiagramLauncher), uses the same method or property names, and provides the same functionality as described in this reference.