en-ca 1999-12-31 $id:$ Doc_Builder DM Solutions Group Inc. chameleon@lists.maptools.org Christopher R. Thorne DM Solutions Group Inc. chameleon@lists.maptools.org Paul Spencer DM Solutions Group Inc. chameleon@lists.maptools.org ErrorReport TBD Utility/Popup Widget 2.0 2005-01-10 TECHRELEASE Paul Spencer DM Solutions Group Inc. chameleon@lists.maptools.org The ErrorReport widget is a utility widget used to display errors that have occurred during processing. Normally, the errors are non-fatal but could be useful in debugging widgets or a new template. If the ErrorReport widget is not in a template, the errors are output as HTML comments at the top of the application page and can be seen by viewing the HTML source of the page. The ErrorReport widget supports attributes from the Button Attributes and Popup Attributes Groups. This means ErrorReport has access to the Style and PopUpCSS Shared Resources. To learn about these Shared Resources, please refer to the appropriate attribute group sections for details. This button is not normally visible to the user. If an error dialog is automatically opened while using an application, read the report and respond accordingly. (This could mean, among other things, contacting the application developer for help.) The ErrorReport widget can be placed within an interface as a button, but doing so is really only useful to the application developer for debugging purposes. The ErrorReport widget can be included in an application being tested but set to be invisible (i.e., visible="false") if you want users to be exposed to errors that occur. For production applications, this widget should be either disabled or removed. In this final case, errors can still be seen by viewing the HTML source of the application page. The error popup window is essentially a message board of captured errors from Chameleon. Other than reading its content and closing the popup window, there are no other means of interaction. <CWC2 TYPE="ErrorReport" ENABLED="[TRUE|FALSE]" FORMINDEX="[0 < integer]" VISIBLE="[TRUE|FALSE]" <!-- Popup Attribute Group--> POPUPHEIGHT="[0 < integer]" POPUPWIDTH="[0 < integer]" MENUBAR="[TRUE|FALSE]" POPUPSTYLERESOURCE="[string]" RESIZABLE="[TRUE|FALSE]" SCROLLBARS="[TRUE|FALSE]" STATUS="[TRUE|FALSE]" TOOLBAR="[TRUE|FALSE]" <!-- Button Attribute Group--> BACKGROUNDIMAGE="[path]" DEFAULT="[TRUE|FALSE]" IMAGE="[path]" IMAGEHEIGHT="[integer]" IMAGETIP="[string]" IMAGEWIDTH="[integer]" LABELALIGN="[LEFT|CENTER|RIGHT]" LABELANTIALIAS="[TRUE|FALSE]" LABELCOLOR="[#RRGGBB]" LABELFONT="[string]" LABELFONTSIZE="[0 < integer]" ONCLICK="[string]" STYLERESOURCE="[string]" TEXTBUTTONBORDER="[path]" TEXTBUTTONBORDER_BOTTOM_IMAGE="[path]" TEXTBUTTONBORDER_BOTTOMLEFT_IMAGE="[path]" TEXTBUTTONBORDER_BOTTOMRIGHT_IMAGE="[path]" TEXTBUTTONBORDER_LEFT_IMAGE="[path]" TEXTBUTTONBORDER_RIGHT_IMAGE="[path]" TEXTBUTTONBORDER_TOP_IMAGE="[path]" TEXTBUTTONBORDER_TOPLEFT_IMAGE="[path]" TEXTBUTTONBORDER_TOPRIGHT_IMAGE="[path]" TEXTBUTTONCOLOR="[#RRGGBB]" TEXTBUTTONNUDGE="[integer]" TEXTBUTTONPADDING="[0 < integer]" TOOLSET="[string]" USETEXTBUTTONCACHE="[TRUE|FALSE]"> <!-- Button Subtag Group --> <IMAGE STATE="[NORMAL|SELECTED|HOVER|DISABLED]" IMAGE="[path]"/> </CWC2> Since the ErrorReport widget uses the Popup Attribute Group, it inherits the Popup Attribute Group's required attributes, POPUPWIDTH and POPUPHEIGHT. <cwc2 type="ErrorReport" popupwidth="500" popupheight="400"/> The following example uses both the Popup and Button Attribute Groups. The widget tag configuration produces a button for the ErrorReport popup. Please note that this widget tag uses two different TextButton Shared Resources. The first TextButton resource styles the button that launches the popup from the application interface, and the second resource holds the text button styles for the buttons found within the popup window. In this case, PopupButtons styles the "Close" button in the ErrorReport popup window. <cwc2 type="ErrorReport" popupwidth="500" popupheight="400" toolbar="false" status="false" menubar="false" visible="true" image="icons/icon_warning.png" imagetip="Display Error Report" label="Error Report" styleresource="TextButtons" popupstyleresource="PopupButtons"> <image state="normal"/> <image state="hover"/> <image state="selected"/> </cwc2> Hawaii Demo www.mapsherpa.com/hawaii2/ The Hawaii Demo uses the latest 1.99 Chameleon version. Base Button Popup DisplayErrors Private Popup a window displaying error messages that occurred.