The Cell Editor is great for fine-grained tuning of your page contents. You can display any combination of text, HTML and database fields. Iron Speed Designer saves your custom contents and faithfully reproduces them when regenerating your web pages. Enter any text and HTML you want:
|
Contents |
Example |
|
Text |
Dear <GEN:FieldValue Name=“FirstName”/>, |
|
HTML |
<font color="red"><GEN:FieldValue Name=“FirstName”/></font> |
|
ASP |
<asp:treeview id=“xxx” runat=“server”> |
|
JavaScript |
<img src="logo.gif" onmouseover="alert('Welcome to Iron Speed!')" /> |
But… don’t modify Iron Speed Designer’s GEN: tags unless you’re an expert. Code generation tags instruct Iron Speed Designer which databound fields to generate.
The following examples illustrate how text, HTML and database field values can be combined.
|
Cell Editor contents |
Displays as |
Purpose |
|
<GEN:FieldValue Name="FirstName"/> |
William |
Displays the database field value. |
|
<font color=”red”><GEN:FieldValue Name="FirstName"/></font> |
William |
Displays the database field value in red. |
|
<a href=’mailto:<GEN:FieldValue Name="EmailAddress"/>’> |
William |
Displays a ‘mailto’ email link. The field should contain a valid email address. |
|
<a href=’<GEN:FieldValue Name="URL"/>’> |
William |
Displays a clickable URL (hyperlink) from the database. The URL field should contain a valid URL. |
|
<a href=’http://www.ironspeed.com/kb?q=<GEN:FieldValue
Name="FirstName"/>’> |
Search for William |
Displays a clickable URL (hyperlink) as part of a query string. |
|
<img src=’<GEN:FieldValue Name="URL"/>’ /> |
|
Displays an image if the field contains a valid URL. |
Do not manually enter (type) code generation tags (GEN: tags) into the Cell Editor. Instead, we recommend you drag controls from the Toolbox onto the Quick Layout Spreadsheet rather than manually entering code generation tags in the Cell Editor. Then, add the appropriate HTML tags via the Cell Editor after dragging controls from the Toolbox onto your page. Dragging controls from the Toolbox ensures they are automatically (and properly) connected to the database. In contrast, manually entered (typed) code generation tags are not bound to your database, and the control won't know where or how to get data from the database, how to format and display the data, etc. You can configure code generation tags via the Properties dialog
Iron Speed Designer generates server controls tags in the generated ASPX and ASCX files. The server-side functionality of the application is exposed to the ASPX pages as a set of XML tags. The ASP.NET control tags may also be used in pages and are passed through to the final generated ASPX page.
The syntax of the ASP.NET control tags is very straightforward:
<NameSpace:TAGNAME
id="IDNAME"
runat="server"
...
>
</NameSpace:TAGNAME>
Example tags for various types of buttons:
|
Tag Type |
Example |
|
Standard HTML form submit button |
<input type="submit" id="b" ... /> |
|
Standard .NET HTML control |
<input type=”submit” id=”b” runat=”server” ... /> |
|
Standard .NET web control |
<asp:Button runat="server" id="b" ... /> |
|
Application base classes custom control |
<BaseClasses:Button runat="server" id="b" ... /> |
|
OMS
application user control |
<OMS:Button runat="server" id="b" ... /> |
Note:
"ASP" is the tag prefix for the standard .NET web controls used in the generated ASPX pages.
"BaseClasses" is the tag prefix associated with the .NET custom controls defined in the application base classes.
The application’s name is used as the tag prefix for the application’s own generated .NET user controls (i.e. the ASCX controls). These tag prefixes are defined in each ASPX / ASCX file using the "<@Register ... >" statements near the top of the files.
Example: Hyperlinking Database Fields
Example: Adding Custom ASCX Controls
Navigating Your Application in Design Mode
Customizing Page Contents with the Cell Editor
Configuring Cell, Row and Table Styles
Placing ASP.NET Directives in Generated Pages
Using Frames in Generated Pages
Using Client-Side JavaScript in Generated Pages
Capturing the Enter Key in Generated Pages
