Required

Telescope.SetupDialog() Method

Displays a setup dialog, allowing the user to set telescope-specific values such as baud rate, geodetic position, etc.

Syntax

Telescope.SetupDialog()

The method syntax has these parts:

Part	Description
Return (Nothing)	Does not return a value.

Remarks

If there are no setup items, a simple popup box with the driver name and version should be displayed, along with a message that no setup or configuration is required. Drivers may raise an error if the telescope is connected when this method is called (as a way of preventing config changes while the driver is active).

The SetupDialog must contain, at a minimum, two graphical elements:

An ASCOM icon (shown on the right), which is hyperlinked to the ASCOM Initiative web site. When the mouse hovers over this icon, it should change to the standard web-link icon . A click on the icon must open a web browser to the ASCOM Initiative home page at http://ASCOM-Standards.org/. The image should also display a hover tool-tip that indicates that the image is a hyperlink to the ASCOM Initiative web site.
A label that appears as Help. This label must behave as a hyperlink (as described in the preceding item) to a local HTML document, included with the driver, and which describes its behavior and other information that may be useful to an end-user of the driver.

NOTE: The setup dialog typically includes selection of the serial (COM) port to be used for telescope communication. If this is implemented in the setup dialog, then it should include the ability to dynamically discover and offer for selection all COM ports on the system. If dynamic discovery is not included, then at least 32 COM ports should be offered for selection. This is necessary because most newer systems use USB-to-serial adapters, and these devices may appear on high-numbered COM ports. Again, dynamic discovery is preferred.