ADSI Hunter

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace ADSIHunter
{
    /// <summary>
    /// Encapsulate the search parameter entry.
    /// </summary>
    public partial class frmSearch : Form
    {
        #region > Private Data <
        /// <summary>
        /// Error message.
        /// </summary>
        private const string _Error = "Please provide something to search for.";

        /// <summary>
        /// Dialog cancelled flag.
        /// </summary>
        private bool _Cancelled = false;

        /// <summary>
        /// The user entered search string.
        /// </summary>
        private string _UserSrch = string.Empty;
        #endregion

        #region > Constructor <
        /// <summary>
        /// Instantiate object.
        /// </summary>
        public frmSearch(string Title)
        {
            InitializeComponent();
            tbTitle.Text = Title;
        }
        #endregion

        #region > Event Handlers <
        /// <summary>
        /// Search button click event handler.
        /// </summary>
        private void btnSearch_Click(object sender, EventArgs e)
        {
            if (tbSearchText.Text.Trim().Length < 1)
            {
                errProvider.SetError(tbSearchText, _Error);
                tbError.Text = _Error;
                tbSearchText.Focus();
                return;
            }
            tbError.Text = string.Empty;
            errProvider.Clear();

            _UserSrch = tbSearchText.Text.Trim();
            this.DialogResult = DialogResult.OK;
            this.Hide();
        }

        /// <summary>
        /// Cancel button click event handler.
        /// </summary>
        private void btnCancel_Click(object sender, EventArgs e)
        {
            _UserSrch = string.Empty;
            this.DialogResult = DialogResult.Cancel;
            this.Hide();
        }
        #endregion

        #region > Public Properties <
        /// <summary>
        /// Get the cancelled flag.
        /// </summary>
        public bool Cancelled
        {
            get { return _Cancelled; }
        }

        /// <summary>
        /// Get the user entered search data.
        /// </summary>
        public string UserSearch
        {
            get { return _UserSrch; }
        }
        #endregion
    }
}