en-ca 1999-12-31 $id:$ Doc_Builder DM Solutions Group Inc. chameleon@lists.maptools.org Paul Spencer DM Solutions Group Inc. chameleon@lists.maptools.org Christopher R. Thorne DM Solutions Group Inc. chameleon@lists.maptools.org UpdateMap TBD Map Widgets 2.0 2005-01-10 TECHRELEASE Paul Spencer DM Solutions Group Inc. chameleon@lists.maptools.org The UpdateMap widget is used to refresh the current page without performing any other navigation. This is useful for sending values from widgets that do not have some more direct form of communication, such as the Scale widget and the LegendTemplate widget. The UpdateMap widget does not use the toolset attribute from the Button Attribute Group. The attribute is blocked by the Update widget code. The UpdateMap widget tag has attributes from Button Attribute Group. This means the UpdateMap widget has access to the Style Shared Resource. To learn more about this Shared Resource, please refer to the appropriate attribute group section for details. This widget provides the capability to update the map image to reflect changes that have not yet been committed. To update the map, click the Update Map button. <CWC2 TYPE="UpdateMap" ENABLED="[TRUE|FALSE]" FORMINDEX="[0 < integer]" VISIBLE="[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> The following is the simplest example of the UpdateMap widget. <cwc2 type="UpdateMap" visible="true" image="buttons/button_update_1.png"/> The following example shows how the UpdateMap widget using the "TextButtons" Shared Resource is called with three possible image states. Also this button contains a label, "Redraw Map", that is written right on the button. <cwc2 type="UpdateMap" visible="true" imagetip="Update Map With Current Selections" image="icons/icon_update.png" label="Redraw Map" styleresource="TextButtons"> <image state="normal" /> <image state="hover" /> <image state="selected" /> </cwc2> The following example shows how the widget could be defined without using a Shared Resource. <cwc2 type="UpdateMap" visible="true" imagetip="Update Map With Current Selections" imagewidth="24" imageheight="24"> <image state="normal" image="buttons/button_update_1.png"/> <image state="hover" image="buttons/button_update_2.png"/> <image state="selected" image="buttons/button_update_3.png"/> </cwc2> Hawaii Demo www.mapsherpa.com/hawaii2/ The Hawaii Demo uses the latest 1.99 Chameleon version. Base Button UPDATE_MAP unknown Set by the UpdateMap widget when the Update Map button is clicked. clickUpdateMap Private Callback function for the user clicking the "Update Map" button.