Click or drag to resize

Chooser Class

The Chooser object provides a way for your application to let your user select the telescope to use.
Inheritance Hierarchy
SystemObject
  ASCOM.UtilitiesChooser

Namespace:  ASCOM.Utilities
Assembly:  ASCOM.Utilities (in ASCOM.Utilities.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
Syntax
Copy
public class Chooser : IDisposable

The Chooser type exposes the following members.

Constructors
  NameDescription
Public methodChooser
Creates a new Chooser object
Top
Properties
  NameDescription
Public propertyDeviceType
The type of device for which the Chooser will select a driver. (String, default = "Telescope")
Top
Methods
  NameDescription
Public methodChoose
Select ASCOM driver to use without pre-selecting in the dropdown list
Public methodChoose(String)
Select ASCOM driver to use including pre-selecting one in the drop-down list
Public methodDispose
Cleans up and disposes objects used by Chooser
Top
Remarks

Calling Chooser.Choose() causes a chooser window to appear, with a drop down selector list containing all of the registered Telescope drivers, listed by the driver's friendly/display name. The user sees a list of telescope types and selects one. Before the OK button will light up, however, the user must click the Setup button, causing the selected driver's setup dialog to appear (it calls the driver's Telescope.SetupDialog() method). When the setup dialog is closed, the OK button will light and allow the user to close the Chooser itself.

The Choose() method returns the DriverID of the selected driver. Choose() allows you to optionally pass the DriverID of a "current" driver (you probably save this in the registry), and the corresponding telescope type is pre-selected in the Chooser's list. In this case, the OK button starts out enabled (lit-up); the assumption is that the pre-selected driver has already been configured.

See Also