Configuring Application Generation Options

Go to:

Tools, Application Generation Options...

You can set certain defaults for the Application Wizard, the New Page dialog and your application, that make their operation more tailored to your use, especially if you are creating a large number of similar pages.

Use the Application Generation Options dialog to configure Application Generation Options.

Selected application generation options are described below.

Page Location Options

Option

Description

Page location

The file folder location where the pages are created.

<Table Name>

Each group of pages is created in a new folder bearing the table’s name.

Existing folder

Select an existing folder to place the new pages.

The Application Wizard only generates pages in sub-folders one level below the application's root folder.  It will not, at present, accommodate a multi-level folder structure.

Menu Controls

Option

Description

Menu type

Specifies the type of menu to generate.

Multi-level

Generate a multi-level ASP.NET menu control.  This menu may be configured by editing the menu control’s sitemap file.

Classic

Generate a ‘link button’ menu control.  This menu may be configured via Iron Speed Designer’s Menu Wizard.

Once your application is created you cannot change the application’s menu type by changing this option; it applies only to newly generated applications.

You can change the menu used within an individual page by deleting the existing menu control from the page.  Then add a new menu panel (Right-click, Insert, Menu).  The new menu panel will appear in the current page.  Menu items from the previous menu panel are not automatically copied to the new menu panel; you must add and configure them separately.

Pages to Create

Option

Description

Edit Table
Show Table
Add Record
Edit Record
Show Record

The specific pre-defined page types that can be automatically created.  The Application Wizard will automatically create pages for the selected page types for any selected database table, database view, or custom query.

You can remove any created page within the Application Wizard or from the Application Explorer window.

Edit Table Panel and Show Table Panel Options

Option

Description

Field filters

Creates several filter controls.  Controls are created only for the first few fields in the underlying database table.

Search controls

A search control is created for the table.  Each field in the table participates in the search.

Enable column sorting

Creates table column headings that, when clicked, sort the table based on the selected column’s data.

Record Panel Options

Option

Description

Panel layout

Specifies how many columns of fields to create in a record panel.

Best Guess

Iron Speed Designer analyzes your table schema and determines how many columns of fields to create.

1 Column
2 Columns
3 Columns

The selected number of panel columns will be created.

Panel field order

Specifies field ordering within a panel, i.e., which field is placed first, second, and so forth.

Best Fit

Wide fields such as image and long text fields are placed at the bottom of the panel, typically spanning several columns.

Database Field Order

Fields are placed in the panel in the order in which they are listed in the database table schema definition without regard to field type or field size.  Wide fields such as images and long text fields are placed in the order they are listed in the table schema.

Panel field direction

Fields in record panels may be laid out either across then down or down then across.  Panel field direction works in conjunction with the “Panel field order” option.

Page Controls Options

Option

Description

Add calendar control for date fields

Enables or disables date selector controls (calendar control) from being placed next to appropriate fields.

Increment and Decrement Buttons

Adds increment and decrement buttons to appropriate number, currency and date fields.  Clicking the increment button increases the value by one logical unit; clicking the decrement button decreases the value by one logical unit.

Smooth Panel Update

Ajax-based panel updating is used for table panels and record panels.  This eliminates ‘postback flicker’ that occurs when panels are updated.

Text Controls Options

Option

Description

Display text as

Enables generation of rich text editor controls on fields exceeding a certain size.

Threshold to display rich text (# chars)

All text fields shorter than this parameter’s value (database column size) will be shown as a HTML source code.  Text fields shorter than this amount will not be displayed as rich text if the ‘Display text as’ option is ‘Rich text’.

Limit text on page to (char #)

Specifies the maximum number of text characters to display for a field.  If the total content length (number of all characters including all HTML tags) exceeds this value, the text is truncated and ellipses (...) are displayed at the end of the text.  Note that rich text cannot be displayed if the amount of text in a field exceeds this value.

The entire text may be displayed in a pop-up text control if enabled.

Large List Selector Controls Options

Option

Description

Display large list selectors

Enables or disables large list selectors from being placed next to appropriate fields.

Large list selector threshold (# items)

Displays large list selector controls next to dropdown lists when the number of list items exceeds this threshold.  Use the MinListItems pass-through attribute in the Properties dialog to set individual controls.

Pop-up Controls Options

Option

Description

Large Text Pop-Up

An Ajax-based pop-up window is displayed when the user mouses over appropriate text fields containing text larger than the specified threshold amount.

Image Pop-Up

An Ajax-based pop-up window is displayed when the user mouses over image fields.

Rich Text Editor Control Options

Option

Description

Rich text editor

Specifies which editor control is generated.  If you choose the ASP Multi-line editor, all fields will be edited with this control regardless of the threshold value.  If ‘FCKEditor’ is chosen, all text fields whose database column length exceeds the Threshold will be edited with FCKEditor.

Threshold for rich text editor (# chars)

Specifies which text fields should be edited by ASP Multi-line editor and which by the editor selected in the ‘Rich text editor’ parameter.

Width

Specifies the width of the editor control window in pixels.

Height

Specifies the height of the editor control window in pixels.

Show rich text editor menu toolbar

Specifies whether editor’s menu toolbar should be shown or hidden when the field is opened for editing.

Note: The rich text editor is enabled via the ‘Display text as’ setting in the Text Controls section.

Security Options

Option

Description

Encrypt URL Parameters

Encrypts URL parameters so that databse primary key values are not visible.  When enabled, the URLs for Show Record and Edit Record pages are encrypted using the Session ID as the encryption key.  In some cases, the URLs for Add Record pages are also encrypted, such as when copying a record.

You may change the encryption key to something other than the Session ID in the Encrypt and Decrypt methods of the BaseApplicationPage class, located in:

...\<Application Name>\App_Code\Shared\BaseApplicationPage.cs (or .vb)

See Also

Configuring Iron Speed Designer Options

FCKEditor Notes