//*************************************************************************
        //  Constructor: TopNByMetricUserSettingsListDialog()
        //
        /// <summary>
        /// Initializes a new instance of the <see
        /// cref="TopNByMetricUserSettingsListDialog" /> class.
        /// </summary>
        ///
        /// <param name="topNByMetricUserSettings">
        /// The object being edited.
        /// </param>
        ///
        /// <param name="workbook">
        /// Workbook containing the graph contents.
        /// </param>
        //*************************************************************************

        public TopNByMetricUserSettingsListDialog
        (
            List <TopNByMetricUserSettings> topNByMetricUserSettings,
            Microsoft.Office.Interop.Excel.Workbook workbook
        )
        {
            Debug.Assert(topNByMetricUserSettings != null);
            Debug.Assert(workbook != null);

            m_oTopNByMetricUserSettings = topNByMetricUserSettings;

            // This dialog edits a clone of the List, then copies the clone back to
            // the original List when OK is pressed.

            m_oTopNByMetricUserSettingsClone = new List <TopNByMetricUserSettings>(
                m_oTopNByMetricUserSettings.Count);

            foreach (TopNByMetricUserSettings oTopNByMetricUserSettings in
                     m_oTopNByMetricUserSettings)
            {
                m_oTopNByMetricUserSettingsClone.Add(
                    oTopNByMetricUserSettings.Clone());
            }

            m_oWorkbook = workbook;

            InitializeComponent();

            // Instantiate an object that saves and retrieves the user settings for
            // this dialog.  Note that the object automatically saves the settings
            // when the form closes.

            m_oTopNByMetricUserSettingsListDialogUserSettings =
                new TopNByMetricUserSettingsListDialogUserSettings(this);

            DoDataExchange(false);

            AssertValid();
        }
    //*************************************************************************
    //  Constructor: TopNByMetricUserSettingsListDialog()
    //
    /// <summary>
    /// Initializes a new instance of the <see
    /// cref="TopNByMetricUserSettingsListDialog" /> class.
    /// </summary>
    ///
    /// <param name="topNByMetricUserSettings">
    /// The object being edited.
    /// </param>
    ///
    /// <param name="workbook">
    /// Workbook containing the graph contents.
    /// </param>
    //*************************************************************************

    public TopNByMetricUserSettingsListDialog
    (
        List<TopNByMetricUserSettings> topNByMetricUserSettings,
        Microsoft.Office.Interop.Excel.Workbook workbook
    )
    {
        Debug.Assert(topNByMetricUserSettings != null);
        Debug.Assert(workbook != null);

        m_oTopNByMetricUserSettings = topNByMetricUserSettings;

        // This dialog edits a clone of the List, then copies the clone back to
        // the original List when OK is pressed.

        m_oTopNByMetricUserSettingsClone = new List<TopNByMetricUserSettings>(
            m_oTopNByMetricUserSettings.Count);

        foreach (TopNByMetricUserSettings oTopNByMetricUserSettings in
            m_oTopNByMetricUserSettings)
        {
            m_oTopNByMetricUserSettingsClone.Add(
                oTopNByMetricUserSettings.Clone() );
        }

        m_oWorkbook = workbook;

        InitializeComponent();

        // Instantiate an object that saves and retrieves the user settings for
        // this dialog.  Note that the object automatically saves the settings
        // when the form closes.

        m_oTopNByMetricUserSettingsListDialogUserSettings =
            new TopNByMetricUserSettingsListDialogUserSettings(this);

        DoDataExchange(false);

        AssertValid();
    }