DEFUI

Tag Name: Definition User Interface (DEFUI)

Tag: <DEFUI>
Arguments: entries, types

This tag encapsulates the HTML for any properties that must be set when the Server.CreateObject call is made for the email object. Some email objects require additional parameters to be set when the email object is declared. This tag allows you to define the user interface for the additional parameters. Leave blank if no UI is necessary.

You can build a user interface with as many form elements as you like but there are some necessary naming conventions that must be followed. Helpful functions, an explanation of naming conventions, and all other necessary information for the Definition user interface can be found in the Creating a Definition User Interface section of this documentation.

There are two arguments available in this tag:

entries: Number of arguments passed from the Definition User Interface to the mail object definition function.

Note: Form elements should use an incrementing naming convention (e.g. "def1", "def2", ... "defn".)

Tip: Default attributes for these form elements can be specified using the form elemetns value tag.
types: Comma-separated list of form element types. They should be listed in the order they are displayed in the email object tab of the Universal Email dialog box. The following is a list of the corresponding argument values for each form element type.
- t = text element (text or password)
- l = list element
- c = checkbox
- r = radio button
- af = absolute file path
- uf = url file path

Sample 1:

Tag argument examples

CDO Mail does not require any extra input for defining the email object:

<WA_UniversalEmail name="CDO Mail"...>
<DEFUI entries="0" types=""></DEFUI>

However, SoftArtisans' SMTP Mail does.

<WA_UniversalEmail name="SoftArtisans SMTP Mail">
<DEFUI entries="4" types="t,af,t,t">
...
</DEFUI>

Sample 2:

SMTPmail interface (also refer to the email object XML file)

<WA_UniversalEmail name="SoftArtisans SMTP Mail">
<DEFUI entries="4" types="t,af,t,t">
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
    <tr>
      <td width="30%"> </td>
      <td width="50%"> </td>
      <td width="20%"> </td>
    </tr>
    <tr>
      <td align="right" valign="baseline">Remote Host:</td>
      <td colspan="2" valign="baseline">
        <input type="text" value='<%=Request.ServerVariables("SERVER_NAME")%>' name="def1" style="width:260px">
        <input type="image" src="../shared/UltraDev/images/Boltup.gif" onClick="openDynamicBinding('def1');"></td>
      </td>
    </tr>
    <tr>
      <td colspan="3"> </td>
    </tr>
    <tr>
      <td align="right" valign="baseline">SMTP Log:</td>
      <td colspan="2" valign="baseline">
          <input type="text" value="" name="def2" style="width:195px">
          <input type="button" value="Browse..." name="d2browse" onClick="openFileBrowse('def2');">
          <input type="image" src="../shared/UltraDev/images/Boltup.gif" onClick="openDynamicBinding('def2');">
      </td>
    </tr>
    <tr>
      <td colspan="3"> </td>
    </tr>
    <tr>
      <td valign="baseline" align="right">Server Login:</td>
      <td colspan=2 valign="baseline">
          <input type="text" name="def3" style="width:100px">
          (Only available with full version)
      </td>
    </tr>
    <tr>
      <td valign="baseline" align="right">Password:</td>
      <td>
        <input type="text" name="def4" style="width:100px">
      </td>
      <td valign="baseline"> </td>
    </tr>
  </table>
</DEFUI>
...