CreateDotNetControl()

Summary

Creates a new .NET Control window.

 

Changes

Added to Version 6.0/2012.

 

Syntax

string = CreateDotNetControl(string name, string assemblyName, string typeName, array options)

 

Argument	Contents
name	The desired name for the .NET control window
assemblyName	The name of the assembly that contains the type for which you are creating an object (for assemblies stored in the system's Global Assembly Cache), or the path to the assembly DLLsl.
typeName	The fully qualified type name, including its namespace

 

Option	Type	Contents
Activate Macro	String	The name of a macro that is called whenever the map is activated
Close Macro	String	The name of a macro called when the user closes the map from the system menu
Context Menu	String	The name of the menu resource to use to display a custom context menu when there is a right click on the window
Done Macro	String	The name of a macro that is called after the window is closed
Event Macro	String	The name of a macro called whenever the control fires an event
Resize Macro	String	The name of a macro called whenever the window is resized by the user
Aspect Ratio	2 integers	The aspect ratio of the window (height, width)
Events	Array	An array of strings for the names of the events for which the macro will be called
Menu	String	The menu associated with the map window
Position	Array	The screen location of the window in an array of 2 integers {x, y}
Size	2 integers	The screen size of the window (x, y)
Toolbar	String	The toolbar associated with the map window

 

Returns

The name of the .NET control window.

 

Notes

• The event macro is called with 3 arguments: the COM interface to the control, the event name as a string, and an array containing the parameters passed by the event.

• The resize macro is called with 3 arguments: the COM interface to the control, and the new width and height of the COM control window in pixels.

• Window size and position are specified as percentages of the frame window.

• If the menu, toolbar, activate macro, or close macro is not specified, CreateDotNetControl() uses the default specified with SetDefaults(). If a layout-specific default was not specified with SetDefaults(), then CreateDotNetControl() uses the generic default.

• Some controls handle the right-click themselves and this will preempt the Context Menu option.

Example

window = CreateDotNetControl("Web", "System.Windows.Forms",

    "System.Windows.Forms.WebBrowser",)

browser = GetDotNetControlObject(window)

browser.Navigate("www.google.com")

 

Error Codes

Error Type	Meaning
Error	One of the options is invalid

 

See Also

Function	Summary
CloseDotNetControl()	Closes the window containing the .NET control
ConvertManagedObjectType()	Access a .NET object using a different interface type
CreateManagedObject()	Creates a new instance of a .NET Object
GetDotNetControlObject()	Gets the .NET object in a .NET control window
GetManagedClass()	Gets an object representing the .NET class for calling static methods
SetDotNetControlTitle()	Sets the title of a .NET control window