PHP Classes

File: awfDialog/docs/usage.php

Recommend this page to a friend!
  Classes of AW Ford   awfDialog Wizard   awfDialog/docs/usage.php   Download  
File: awfDialog/docs/usage.php
Role: Documentation
Content type: text/plain
Description: Detailed property and method reference
Class: awfDialog Wizard
Generate wizard-like Web user interface using AJAX
Author: By
Last change: v 1.2 update
Date: 16 years ago
Size: 33,299 bytes
 

Contents

Class file image Download
<?php //Version 1.2 (final) include('../lib/awfDialog.php'); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>awfDialog Class :: Usage Guide</title> <link rel="stylesheet" href="style.css" type="text/css" media="screen" /> </head> <body> <div class="header"> <img src="images/testlab2.jpg" align=right><img src="images/testlabhead.jpg"> </div> <div class="content"> <table width="100%" cellpadding="2" cellspacing="1" border="0"> <tr> <td width="100%" valign="top"> <font size="1">awfDialog :: AJAX Enabled Dynamic Dialog Wizard Class :: Documentation</font><br><br> &nbsp;&nbsp;<small><a href='#quick'><font color='#008800'>Quick Start</font></a></small> &nbsp;&nbsp;<small><a href='#props'><font color='#008800'>Properties</font></a></small> &nbsp;&nbsp;<small><a href='#methods'><font color='#008800'>Methods</font></a></small> <center> <div id='container'> <?php $str1=""; $m1 = new awfDialog('D1','awfDialog Class Quick Start',$str1, ICON_HELP,false,'85%'); $m1->SetImagePath("../lib/images/"); $m1->SetIconSize(ICON_SIZE_LG); $m1->SetGradient('224e15','c3f60a'); $m1->SetImagePHPURL('../lib/image2.php'); $m1->SetGradientDirection(GRADIENT_V); $m1->SetBodyBGColor('#efffca'); $m1->AddOutput("<a name='quick'></a><ol style='margin-left:30px;font-size:smaller;'>"); $m1->AddOutput("<li>Unzip the contents of the package zip file</li>"); $m1->AddOutput("<li>Upload the the awfdialog directory and all sub-directories to your server.</li>"); $m1->AddOutput("<li>Include the class using: <b> include('awfDialog/lib/awfDialog.php'); </b><br>Change the include path based on relativity to file doing the inclusion."); $m1->AddOutput("<li>Create an instance of the class:<br>"); $m1->AddOutput("<b>&nbsp;&nbsp;\$myClass = new awfDialog('id','My First Dialog','Hello World!', ICON_INFO,false,'300');</b><br>"); $m1->AddOutput("Start manipulating the class using available functions and properties. See below for detailed description of each.</li>"); $m1->AddOutput("<li>When you're ready to render your dialog box:<br>"); $m1->AddOutput("<b>&nbsp;&nbsp;\$myClass->Render();</b></li>"); $m1->AddOutput("<li>Happy coding!</li>"); $m1->AddOutput("</ol>"); $m1->Render(); $m1->SetID("D2"); $m1->SetTitle("awfDialog Detailed Guide"); $m1->Clear(); $m1->AddOutput("<br>"); // START CLASS PROPERTIES SECTION $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><h2><a name='props'></a>Class Properties</h2></div>"); //dialogID $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dialogID:</b><li><i>String, required. </i>Unique identifier for the dialog box to be rendered. Useful, for instance, when creating sequential dialogs as in an application and you need to know your current position within the sequence. Also used as the prefix for all CSS classes and id's assigned to dialog elements to guarantee uniqueness when rendering multiple dialogs on a page.<br><br>See SetID() method.</dl></div><hr>"); //dAjaxCancel $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><img src='".$m1->dImagePath."wizCancel.gif' align=right alt='Cancel Button' title='Cancel Button'><b>dAjaxCancel:</b><li><i>String. </i>Client-side Javascript method to tie to the Cancel button's onClick event. If empty, no Cancel button is rendered.<br><br>See SetAjaxCancel() method</dl></div><hr>"); //dAjaxNext $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><img src='".$m1->dImagePath."wizNext.gif' align=right alt='Next Button' title='Next Button'><b>dAjaxNext:</b><li><i>String. </i>Client-side Javascript method to tie to the Next button's onClick event. If empty, no Next button is rendered.<br><br>See SetAjaxNext() method</dl></div><hr>"); //dAjaxPrev $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><img src='".$m1->dImagePath."wizPrev.gif' align=right alt='Previous Button' title='Previous Button'><b>dAjaxPrev:</b><li><i>String. </i>Client-side Javascript method to tie to the Previous button's onClick event. If empty, no Previous button is rendered.<br><br>See SetAjaxPrev() method</dl></div><hr>"); //dBodyBGColor $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dWizBGColor:</b><li><i>String, hex. </i>Hexideciaml color code to use when rendering the Body pane of the dialog.<br><br>See SetBodyBGColor() method.</dl></div><hr>"); //dBodyHAlign $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dBodyHAlign:</b><li><i>Constant, integer. </i>Determines the horizontal alignment of the body element of the dialog. Accepts one of three constant values:<br>&nbsp;&nbsp;<b>BODY_LEFT</b>, align left<br>&nbsp;&nbsp;<b>BODY_CENTER</b>, align center<br>&nbsp;&nbsp;<b>BODY_RIGHT</b>, align right<br><br>No direct method to set, use <b>\$MyClass->dBodyHAlign=VALUE</b>.</dl></div><hr>"); //dBodyVAlign $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dBodyVAlign:</b><li><i>Constant, integer. </i>Determines the vertical alignment of the body element of the dialog. Accepts one of three constant values:<br>&nbsp;&nbsp;<b>BODY_TOP</b>, align top<br>&nbsp;&nbsp;<b>BODY_MIDDLE</b>, align middle<br>&nbsp;&nbsp;<b>BODY_BOTTOM</b>, align bottom<br><br>No direct method to set, use <b>\$MyClass->dBodyVAlign=VALUE</b>.</dl></div><hr>"); //dCSSArray $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dCSSArray:</b><li><i>Array. </i>Stores CSS element values prior to Render().<br><br>See SetCSS() method below.</dl></div><hr>"); //dCSSOut $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dCSSOut:</b><li><i>String. </i>Final CSS output string sent to the browser during Render().<br><br>See SettCSS() method below.</dl></div><hr>"); //dGradientDirection $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dGradientDirection:</b><li><i>Constant, integer. </i>Determines the direction to render the dynamic gradient image. Accepts one of two constant values:<br>&nbsp;&nbsp;<b>GRADIENT_H</b>, horizontal<br>&nbsp;&nbsp;<b>GRADIENT_V</b>, vertical<br><br>See SetGradientDirection() method.</dl></div><hr>"); //dIconSize $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dIconSize:</b><li><i>Integer, constant, default ICON_SIZE_LG. </i>Determines whether to render a small (20x20) or large (32x32) icon. Accepts one of two constant values:<br>&nbsp;&nbsp;<b>ICON_SIZE_LG</b>, large icon<br>&nbsp;&nbsp;<b>ICON_SIZE_SM</b>, small icon<br><br>See SetIconSize() method.</dl></div><hr>"); //Start constant table - dIconType $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl>"); $m1->AddOutput("<div style='float:right'><table cellpadding='4' cellspacing='0' class='constant'><tr ><th><b>Constant</b></th><th><b>Value</b></th><th><b>Icon</b></th></tr>"); $m1->AddOutput("<tr><td>ICON_NONE</td><td>0</td><td>none</td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_CSS</td><td class='alt'>1</td><td class='alt'>custom</td></tr>"); $m1->AddOutput("<tr><td>ICON_INFO</td><td>2</td><td><img src='../lib/images/icoInfo.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_HELP</td><td class='alt'>3</td><td class='alt'><img src='../lib/images/icoHelp.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_WARN</td><td>4</td><td><img src='../lib/images/icoWarn.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_ERROR</td><td class='alt'>5</td><td class='alt'><img src='../lib/images/icoError.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_WIZARD</td><td>6</td><td><img src='../lib/images/icoWizard.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_CONFIG</td><td class='alt'>7</td><td class='alt'><img src='../lib/images/icoConfig.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_CHAT</td><td>8</td><td><img src='../lib/images/icoChat.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_SEARCH</td><td class='alt'>9</td><td class='alt'><img src='../lib/images/icoSearch.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_USERS</td><td>10</td><td><img src='../lib/images/icoUsers.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_USER</td><td class='alt'>11</td><td class='alt'><img src='../lib/images/icoUser.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_MAIL</td><td>12</td><td><img src='../lib/images/icoMail.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_DOWNLOAD</td><td class='alt'>13</td><td class='alt'><img src='../lib/images/icoDownload.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_UPLOAD</td><td>14</td><td><img src='../lib/images/icoUpload.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_KEY</td><td class='alt'>15</td><td class='alt'><img src='../lib/images/icoKey.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_LOCKED</td><td>16</td><td><img src='../lib/images/icoLocked.gif'></td></tr>"); $m1->AddOutput("<tr><td class='alt'>ICON_UNLOCKED</td><td class='alt'>17</td><td class='alt'><img src='../lib/images/icoUnlocked.gif'></td></tr>"); $m1->AddOutput("<tr><td>ICON_MONEY</td><td>18</td><td><img src='../lib/images/icoMoney.gif'></td></tr>"); $m1->AddOutput("</table><br></div>"); //End constant table //dIconType detail $m1->AddOutput("<b>dIconType:</b><li><i>Constant. </i>Property determines which icon, if any, is rendered in the top left hand corner of the title bar element. The table at right shows available constants and their associated icons. <br><br>See SetIcon() method.</li></dl><hr>"); //dIconValue $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dIconValue:</b><li><i>String. </i>Path and filename to use if dIconType is set to ICON_CSS in order to use custom icons instead of those supported natively by the class.<br><br>See SetIconType() method.</dl></div><hr>"); //dImagePath $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dImagePath:</b><li><i>String. </i>Relative path to thr 'awfDialog/lib/images/' directory. Prefixed to all image renders done by the class.<br><br>See SetImagePath() method.</dl></div><hr>"); //dModal $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><img src='".$m1->dImagePath."exit.gif' align=right alt='Exit Button' title='Exit Button'><b>dModal:</b><li><i>Boolean, default false. </i>Determines whether or not to render the dialog in modal form. It true, the dialog cannot be closed and the Exit button is not rendered.<br><br>See SetModal() method.</dl></div><hr>"); //dProcessArray $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dProcessArray:</b><li><i>Array. </i>Internal class debug event log.<br><br>See DebugDump() & _debug() methods.</dl></div><hr>"); //dOutput $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dOutput:</b><li><i>String. </i>HTML/browser output to render in the body element of the dialog.<br><br>See AddOutput() & Render() methods.</dl></div><hr>"); //dScrollType $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dScrollType:</b><li><i>--. </i>Reserved for future versions.</dl></div><hr>"); //dTitle $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dTitle:</b><li><i>String. </i>Title text to display in the title bar of the dialog. Can be set during class instatiation or afterwards.<br><br>See SetTitle() method.</dl></div><hr>"); //dTitleBGColor $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dTitleBGColor:</b><li><i>String, hex value. </i>Hexidecimal color code for the background of the title bar element of the dialog.<br><br>See SetTitleBGColor() method.</dl></div><hr>"); //dTitleGrad1 $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dTitleGrad1:</b><li><i>String. </i>Hex code (minus hash symbol) used for the start point of the title gradient.<br><br>See SetGradient() method.</dl></div><hr>"); //dTitleGrad2 $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dTitleGrad2:</b><li><i>String. </i>Hex code (minus hash symbol) used for the end point of the title gradient.<br><br>See SetGradient() method.</dl></div><hr>"); //dUseGradient $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dUseGradient:</b><li><i>Boolean, default false. </i>If true, the titlebar element will be rendered with a dynamically generated gradient image across the background. If you set hex values using SetGradient() you will automatically set this to true.<br><br>See SetGradient() method.</dl></div><hr>"); //dUseWizImg $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dUseWizImg:</b><li><i>Boolean, default true. </i>When Wizrd Mode is enabled the display of a wizard image is optional. When set to false, this variable disables rendering the wizard image.<br><br>See DisableWizImage() and EnableWizImage() methods.</dl></div><hr>"); //dVersion $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dVersion:</b><li><i>String, read only. </i>Derived from the VERSION constant of the class. Primarily used for version verification and debug information.</dl></div><hr>"); //dWidth $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dWidth:</b><li><i>String. </i>Width value at which to render the dialog. Can be either fixed pixel width or percentage based.<br><br>See SetWidth() method.</dl></div><hr>"); //dWizBGColor $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dWizBGColor:</b><li><i>String, hex. </i>Hexideciaml color code to use when rendering the Wizard pane.<br><br>See SetWizBGColor() method.</dl></div><hr>"); //dWizImage $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><img src='".$m1->dImagePath."wizDefault.jpg' align=right alt='Default Wizard Image' title='Default Wizard Image'><b>dWizImage:</b><li><i>String. </i>Relative path to image to use if dUseWizImg is true. when left empty the dialog will render the default wizard image from 'awfDialog/lib/images/'.<br><br>See SetWizImage() method.</dl></div><hr>"); //dWizMode $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>dWizMode:</b><li><i>Boolean, default false. </i>Determines if the dialog will be rendered with the various wizard-style features enabled.<br><br>See SetWizMode() method.</dl></div><hr>"); //imagePHPBase $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>imagePHPBase:</b><li><i>String. </i>Relative path to pointing to 'awfDialog/lib/image2.php'. Used to ensure your code knows how to find image2.php, which is the file that generated the dynamic grandient title image. <br><br>See SetImagePHPURL() method.</dl></div><hr>"); //imagePHPURL $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>imagePHPURL:</b><li><i>String. </i>Final path to pointing to the image2.php file and includes all querystring parameters for color1, color2, width, height, and direction of the gradient to be rendered. <br><br>See SetImagePHPURL() method.</dl></div><hr>"); // START CLASS METHODS SECTION $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><h2><a name='methods'></a>Class Methods</h2></div>"); //awfDialog() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>awfDialog(</b>string \$id [, string \$title [, string \$message [, integer \$icotype [boolean \$modal [, string width]]]]]<b>):</b><li><i>Class instantiation method. </i>This method is used when creating a new instance of the awfDialog class using the 'new' directive, as in:<br><br><pre>\$MyClass = new awfDialog('id1');</pre><br></li><li><i>\$id</i> - The unique DOM id to assign to the dialog. Required.</li><li><i>\$title</i> - Text to be rendered in the title bar element of the dialog. Optional.</li><li><i>\$message</i> - HTML to be sent to the Body element of the dialog. Optional. See AddOutput() method for more information on sending content to the Body element.</li><li><i>\$icotype</i> - Icon to render in the upper left corner of the title bar element. Optional. Default value is ICON_NONE. Accepts any one of the icon type constants provided by the class. See dIconType in the properties section above for a complete list.</li><li><i>\$modal</i> - Determines if the dialog can be closed. Default value is false. If false, the form is not modal, meaning the Render() method will included the Exit button in the upper right corner of the title bar element, as well as the javascript used to close the dialog. If true, the dialog is modal and cannot be closed.</li><li><i>\$width</i> - Width of the dialog box. Optional, default = 0. Accepts both pixel or percentage values. Note, this is also used to determine the width of the gradient image, if dUseGradient is true (See SetGradient() method.) Because of this, if you use both a percentage based width as well as a horizontal gradient the image will not fit the title bar width. It is highly recommended to only use pixel values for width when using horizontal gradients.</li></dl></div><hr>"); //AddHelp() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>AddHelp(</b>string \$string <b>):</b><li>Appends HTML / text to the end of the output buffer for rendering in the Help pane during the Render() method. Example usage:<br><br><pre>\$MyClass->AddHelp('How may I help you?');</pre><br></li><li><i>\$string</i> - Properly escape special characters, quotes, etc, just as you would when using the echo statement.</li></dl></div><hr>"); //AddOutput() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>AddOutput(</b>string \$data <b>):</b><li>Appends HTML / text to the end of the output buffer for rendering in the Body pane during the Render() method. Example usage:<br><br><pre>\$MyClass->AddOutput('How do you like my wizard?');</pre><br></li><li><i>\$data</i> - Properly escape special characters, quotes, etc, just as you would when using the echo statement.</li></dl></div><hr>"); //Clear() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>Clear():</b><li>Clears the BodyPane and HelpPane output buffers while maintaining all the other class properties. Example usage:<br><br><pre>\$MyClass->Clear();</pre><br> Use Clear() and SetID() together to quickly reproduce multiple dialogs while only setting the majority of properties once.</li></dl></div><hr>"); //DebugDump() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>DebugDump():</b><li>Immediately prints the formatted contents of the debug log. Example usage:<br><br><pre>\$MyClass->DebugDump();</pre><br> </li></dl></div><hr>"); //DisableWizImage() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>DisableWizImage():</b><li>Turns off rendering of the Wizard pane when dWizMode = true, without effecting the render of wizard-style AJAX buttons. Example usage:<br><br><pre>\$MyClass->DisableWizImage();</pre><br> See EnableWizImage() and SetWizMode() methods.</li></dl></div><hr>"); //EnableWizImage() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>EnableWizImage():</b><li>Turns on rendering of the Wizard pane when dWizMode = true. Example usage:<br><br><pre>\$MyClass->EnableWizImage();</pre><br> See DisableWizImage() and SetWizMode() methods.</li></dl></div><hr>"); //Render() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>Render():</b><li>Draw the dialog. Example usage:<br><br><pre>\$MyClass->Render();</pre><br> </li></dl></div><hr>"); //SetAjaxCancel() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetAjaxCancel(</b>string \$scriptname <b>):</b><li>Assigns a javascript method to the Cancel button's onClick event. Example usage:<br><br><pre>\$MyClass->SetAjaxCancel(\"doStop('something')\");</pre><br>In this example, the Cancel button will call the doStop() javascript method when clicked, passing in the value 'something'. See the Gradient Builder example for a complete study on setting up the AJAX calls and using this method.</li><li><i>\$scriptname</i> - Name of the javascript method to reference.</li></dl></div><hr>"); //SetAjaxHelp() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetAjaxHelp(</b>string \$script <b>):</b><li>Assigns a javascript method to the Help button's onClick event. If this value is not set, either through SetAjaxHelp() or with UseHelp(), and UseHelp() is true, then the Help Button will open the HelpPane instead of making an Ajax call. Example usage:<br><br><pre>\$MyClass->SetAjaxHelp(\"doHelp('something')\");</pre><br>In this example, the help button will call the doHelp() javascript method when clicked, passing in the value 'something'. See the Gradient Builder example for a complete study on setting up the AJAX calls and using this method.</li><li><i>\$script</i> - Name of the javascript method to reference.</li></dl></div><hr>"); //SetAjaxNext() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetAjaxNext(</b>string \$scriptname <b>):</b><li>Assigns a javascript method to the Next button's onClick event. Example usage:<br><br><pre>\$MyClass->SetAjaxNext(\"alert('You clicked Next!')\");</pre><br>In this example, the Next button will call the alert() javascript method, when clicked, passing in the value 'You clicked Next!'. See the Gradient Builder example for a complete study on setting up the AJAX calls and using this method.</li><li><i>\$scriptname</i> - Name of the javascript method to reference.</li></dl></div><hr>"); //SetAjaxPrev() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetAjaxPrev(</b>string \$scriptname <b>):</b><li>Assigns a javascript method to the Previous button's onClick event. Example usage:<br><br><pre>\$MyClass->SetAjaxPrev(\"doStart('something')\");</pre><br>In this example, the Previous button will call the doStart() javascript method, when clicked, passing in the value 'something'. See the Gradient Builder example for a complete study on setting up the AJAX calls and using this method.</li><li><i>\$scriptname</i> - Name of the javascript method to reference.</li></dl></div><hr>"); //SetBodyBGColor() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetBodyBGColor(</b>string \$hex <b>):</b><li>Sets the background color of the Body element. Example usage:<br><br><pre>\$MyClass->SetBodyBGColor('#ffffaa');</pre><br>The above example would set the Body element background to light yellow.</li><li><i>\$hex</i> - Hexidecimal color code, including hash symbol (#).</li></dl></div><hr>"); //SetGradient() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetGradient(</b>string \$color1, string \$color2 <b>):</b><li>Sets the colors to use when generating a dynamic gradient image for the titlebar element of the dialog. Example usage:<br><br><pre>\$MyClass->SetGradient('ffcc00','ffffaa');</pre><br>The above example would produce an image fading from gold to light yellow</li><li><i>\$color1</i> - Hexidecimal color value for the gradient start point without the hash symbol (#).</li><li><i>\$color2</i> - Hexidecimal color value for the gradient end point without the hash symbol (#).</li></dl></div><hr>"); //SetGradientDirection() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetGradientDirection(</b>integer \$direction <b>):</b><li>Sets the direction to use when generating a dynamic gradient image for the titlebar element of the dialog. Default is GRADIENT_V. Example usage:<br><br><pre>\$MyClass->SetGradientDirection(GRADIENT_H);</pre><br>The above example would set the gradient image for horizontal rendering</li><li><i>\$direction</i> - Accepts one of two possible constant values:<br>&nbsp;&nbsp;<b>GRADIENT_H</b>, 0, horizontal<br>&nbsp;&nbsp;<b>GRADIENT_V</b>, 1, vertical</li></dl></div><hr>"); //SetHAlign() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetHAlign(</b>integer \$value <b>):</b><li>Sets the horizontal alignment of the Body element. Example usage:<br><br><pre>\$MyClass->SetHAlign(BODY_LEFT);</pre><br>The above example would set the Body element horizontal alignment to 3, which gets rendered as 'align=left' during the Render() method.</li><li><i>\$value</i> - Can be any one of three constants: <br>&nbsp;&nbsp;<b>BODY_LEFT</b>, 3<br>&nbsp;&nbsp;<b>BODY_CENTER</b>, 4<br>&nbsp;&nbsp;<b>BODY_RIGHT</b>, 5</li></dl></div><hr>"); //SetIcon() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetIcon(</b>integer \$type [, string \$value] <b>):</b><li>Sets the icon to use, if any, on the dialog. Example usage:<br><br><pre>\$MyClass->SetIcon(ICON_INFO);</pre><br> </li><li><i>\$type</i> - Constant value. See dIconType property above for a complete list of available icons.</li><li><i>\$value</i> - Optional. Override path to the image to be used when \$type is set to ICON_CSS.</li></dl></div><hr>"); //SetIconSize() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetIconSize(</b>integer \$size <b>):</b><li>Sets the size of the icon rendered in the titlebar element. Example usage:<br><br><pre>\$MyClass->SetIconSize(ICON_SIZE_SM);</pre><br>The above example would set icon size to approximately 20x20.</li><li><i>\$size</i> - Can be one of two constants: <br>&nbsp;&nbsp;<b>ICON_SIZE_SM</b>, 0<br>&nbsp;&nbsp;<b>ICON_SIZE_LG</b>, 1</li></dl></div><hr>"); //SetID() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetID(</b>string \$id <b>):</b><li>Sets the unique DOM id of the dialog. The dialogID gets prefixed to all elements in the dialog to allow for extended output control via CSS. Example usage:<br><br><pre>\$MyClass->SetID('Hdu5');</pre><br>The above example would replace the id used when instatiating \$MyClass with 'Hdu5'. This way you don't need to have more than a single instance of the awfDialog class instantiated in order to generate multiple dialogs with differing CSS styles.</li><li><i>\$id</i> - Unique id to assign the dialog.</li></dl></div><hr>"); //SetImagePath() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetImagePath(</b>string \$path <b>):</b><li>awfDialog needs to know where to find the various icon and button images it uses during the Render() method. By default, it assumes you have installed the class in a subdirectory from your current execution path, as in 'awfDialog/lib/images/'. If the class is located somewhere else, you'll need to override this behavior. Example usage:<br><br><pre>\$MyClass->SetImagePath('../../awfDialog/lib/images/');</pre><br>As this is a directory path, make sure your \$path value includes the trailing '/'.</li><li><i>\$path</i> - Absolute or relative path to the images directory.</li></dl></div><hr>"); //SetImagePHPURL() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetImagePHPURL(</b>string \$url <b>):</b><li>awfDialog needs to know where to find the file used to generate the dynamic gradient image during the Render() method. This file is in the 'awfDialog/lib/' directory along with the 'class.gradient_image.php' file. Both files need to be in the same directory. Example usage:<br><br><pre>\$MyClass->SetImagePHPURL('../../awfDialog/lib/image2.php');</pre><br>or<br><br><pre>\$MyClass->SetImagePHPURL('http://yourdomain.com/app/awfDialog/lib/image2.php');</pre><br>Make sure your \$url value includes the 'image2.php' filename.</li><li><i>\$url</i> - Absolute or relative url to the lib directory.</li></dl></div><hr>"); //SetModal() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetModal(</b>boolean \$value <b>):</b><li>Sets the dialog modal or non-modal. Default false. If true, the dialog is modal, meaning it cannot be closed, so the Exit button is not rendered to the titlebar element. If false, the dialog is able to be closed. Example usage:<br><br><pre>\$MyClass->SetModal(true);</pre><br> </li><li><i>\$value</i> - True or false.</li></dl></div><hr>"); //SetTitle() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetTitle(</b>string \$title <b>):</b><li>Sets the title string to be rendered in the titlebar element. Example usage:<br><br><pre>\$MyClass->SetTitle('Blackjack Install Wizard');</pre><br> </li><li><i>\$title</i> - Title string to assign to the dialog.</li></dl></div><hr>"); //SetTitleBGColor() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetTitleBGColor(</b>string \$hex <b>):</b><li>Sets the background color of the titlebar element. Example usage:<br><br><pre>\$MyClass->SetTitleBGColor('#ffffff');</pre><br>The above example would set the titlebar element background to white.</li><li><i>\$hex</i> - Hexidecimal color code, including hash symbol (#).</li></dl></div><hr>"); //SetVAlign() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetVAlign(</b>integer \$value <b>):</b><li>Sets the vertical alignment of the Body element. Example usage:<br><br><pre>\$MyClass->SetVAlign(BODY_TOP);</pre><br>The above example would set the Body element vertical alignment to 0, which gets rendered as 'valign=top' during the Render() method.</li><li><i>\$value</i> - Can be any one of three constants: <br>&nbsp;&nbsp;<b>BODY_TOP</b>, 0<br>&nbsp;&nbsp;<b>BODY_MIDDLE</b>, 1<br>&nbsp;&nbsp;<b>BODY_BOTTOM</b>, 2</li></dl></div><hr>"); //SetWidth() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetWidth(</b>string \$width <b>):</b><li>Sets the width of the dialog and the gradient image in the titlebar element. Example usage:<br><br><pre>\$MyClass->SetWidth('65%');</pre><br> </li><li><i>\$width</i> - Accepts both pixel and percentage width values.</li></dl></div><hr>"); //SetWizBGColor() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetWizBGColor(</b>string \$hex <b>):</b><li>Sets the background color of the Wizard pane. Example usage:<br><br><pre>\$MyClass->SetWizBGColor('#ffcc00');</pre><br>The above example would set the Wizard pane background to gold.</li><li><i>\$hex</i> - Hexidecimal color code, including hash symbol (#).</li></dl></div><hr>"); //SetWizImage() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetWizImage(</b>string \$path <b>):</b><li>Sets the path for the image to display in the Wizard pane. By default, awfDialog will use the 'wizDefault.jpg' file located in 'awfDialog/lib/images' directory. Example usage:<br><br><pre>\$MyClass->SetWizImage('http://mysite.com/images/myWiz.jpg');</pre><br></li><li><i>\$path</i> - Absolute or relative path to the desired image.</li></dl></div><hr>"); //SetWizMode() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>SetWizMode(</b>boolean \$mode <b>):</b><li>Determines if the dialog will render the Wizard image and AJAX buttons. Example usage:<br><br><pre>\$MyClass->SetWizMode(false);</pre><br>Note, setting this to false on a dialog that previously had wizard properties enabled also clears those properties.</li><li><i>\$mode</i> - True or false.</li></dl></div><hr>"); //UseHelp() $m1->AddOutput("<div style='margin:5px 15px;font-size:10pt'><dl><b>UseHelp(</b>boolean \$value [, string \$script] <b>):</b><li>Determines if the dialog will render the the Help button in the title bar, the behavior of that button, and if the HelpPane will be rendered to the BodyPane. Example usage:<br><br><pre>\$MyClass->UseHelp(true, 'alert(\"this is a test\")');</pre><br>In the above example, the help button will be displayed, however, since the optional \$script variable was supplied, if overrides the original behavior: instead of rendering the HelpPane, clicking the button will trigger a javascript alert() method. Had the \$scipt variable been left blank the HelpPane would have been rendered containing any output written to it using the AddHelp() method.<br><br> Note, setting this to false on a dialog that previously had help enabled also clears dAjaxHelp property.</li><li><i>\$value</i> - True or false.</li><li><i>\$script</i> - String, optional. If set, overrides the behavior of the Help Button with the passed in client-side Ajax call.</li></dl>See <b>AddHelp()</b>, and <b>SetAjaxHelp()</b> methods. </div><hr>"); $m1->Render(); $m1->Clear(); ?> </div> <!--<div id='error'><textarea id="raw" cols=75 rows=10 class="color"></textarea><br>--> </center> </td> <td width="120px" bgcolor="#efffca" valign="top" class="quick"> <?php include('docmenu.php');?> </td> </tr> </table> </div> <div class="footer"> <img src="images/KLNminilogo.jpg"><br><font color="white"> TestLab is an internal-use only production of <a href="http://knowledgelinknetwork.net">Knowledge Link Network</a></font><br> </div> </body> </html>