Kushal Tutorials - Document


When designing forms in Kushal, you can find that several Controls get automatically created (the specific Controls depend on the type of form chosen for the design). Kushal provides a list of commonly used Controls which you might need in order to enhance these forms with additional functionalities. In addition to this, Kushal also includes Controls which are designed for regular usage.

For instance, Link Control of Kushal accepts a URL and opens a web browser with specified URL, when clicked.

Another example is 'Open Dialog' Control - which includes text box and a button, where if you specify the file extension, this Control set will open an Open dialog box with a specified file extension in the designed application.



List of Controls in Kushal

<add a hyperlink to each Control>

Now let us see the controls available in Kushal and their specific properties in brief.

Label control represents a Label. You can add this Control to any type of Form in Kushal.

The Link Control is an improved Label Control to which you can assign a URL to its Action property. By clicking on this Label at runtime, the default browser with the specified URL opens.

The Email Control is an improvement over the label control that has provision to specify Email ID in its Action property. When you click on this label control, an Email dialog-box opens up in the designed application.

ERachana Date Control is an enhanced TextBox Control specifically designed to accept a date. Users can type just 15 4 12 to set the date - 15th of April 2012.

You can use the Association Properties of this control to associate this control's data input to the specific column of the associated database table.

ERachana Date and Time Control is an enhanced textbox Control specifically designed to accept a date. Users can type just 15 4 12 to set a date - 15th of April 2012. You can use the Association Properties of this control to associate this control's data input to the specific column of the associated database table.

Time Picker Control is an enhanced date time picker Control specifically designed to accept only time. This will enable you to choose the time in the Kushal designed application. You can use the Association Properties of this control to associate the data input to a specific column of a database table to this Control.

The ListBox Control is with little enhancement to accept a SQL Statement or an item collection to display required field values in the designed application.

The Textbox Control is used to display or accept as input, a single line of text.

A MaskedTextBox control provides a validation mechanism for user input on a Form. In addition to the basic properties of the TextBox Control, this Control has some special properties added in Kushal. For instance, if you want a TextBox to accept Telephone number in (999)999-9999 format, you can set the Mask property in the MaskedTextBox. This Control helps you add a masked text to distinguish between proper and improper user input.

This Control is an enhanced TextBox which accepts only numeric and decimal values. In the Association Properties, you can associate the data input to a specific column of a database table to this Control.

The decimal TextBox is an improved version of TextBox. It differs from a Numeric text box as it supports '.' (the "dot" Character), in addition to numeric values to store decimal values.

The currency TextBox is an improved TextBox Control. It displays the amount entered as currency.

Dropdown Control of Kushal supports SQL Statement or Item Collection as the input source. This is set in the SQL property. In the Association Properties, you can associate the data input to a specific column of a database table to this Control.

The Radio buttons are used when you want to give the user a choice between several mutually exclusive options. Generally, the radio buttons are set within a RadioButtonPanel Control. The Checked property sets the state of the control.

Radio button panel is used with a set of radio buttons when any one option has to be selected among multiple options. This Control allows you to select one radio button at a time. It will read the value from the checked radio button and send the corresponding value to the database table field.

The checkbox control is used when you want to allow the user to choose one or more options. It will read the value from checked checkbox through the Checked property and send the corresponding value to the database table field.

A button is primarily used to perform three kinds of tasks:

Ø To perform an action on data entered on a dialog (for example clicking Search after entering some search criteria)

Ø To open another dialog or application (for example, Help buttons)

Ø To close a dialog with a state (for example, OK and Cancel buttons)

Button Control of Kushal has a property group Action using which button behavior can be configured.

The Image Control of Kushal is used to display images in various formats like GIF, JPG, BMP, etc., either at design time or runtime. The path of the image file for the image to be displayed is set in the Image property of the control.

The Data Grid is one of the most important Controls when developing a database application. This Control supports SQL statement implicitly. You can configure the property of each column of the grid.

Group box (Frame) Control is used to group a set of Controls. This Control behaves the same as in Visual Studio with some minor enhancements.

Tab Control allows you to arrange the Form's Controls under various Tabs for better user experience.

Tree View is a set of Controls that include a Tree View Control and four buttons that enable the hierarchical representation of data at runtime.

When you add the Open File Dialog Control to your form, Kushal will create two Controls - Textbox and Button, where if you specify the file extension in button control, this Control set will open an Open dialog box with a specified file extension in the designed application.

When you add the Save File Dialog, Kushal will create 2 Controls - Textbox, Button. In button, you have to configure which type of file needs to save. For example, if you want to save the file with a .abc, you can specify that. Then at runtime, if you click on the button and specify a file name, this Control will automatically append the extension and show the full file path within the associated textbox.

When you add the Browse Folder Dialog, Kushal will create 2 Controls - Textbox, Button. In button, you have to configure which type of file needs to browse. For example, if you want to select only document files you have to give 'doc' as the File Extension. Then during runtime, if we click on the button, it will display only files with a .doc extension and once the file is selected, it will populate the related textbox with that file name.

When you add the Browse Image, Kushal will create 3 Controls - Image Layout, Textbox, Button. In this, you need not configure button or textbox with image layout. By default textbox and button are associated with image layout.