The Common-Controls Tag Library

<forms:reset>

The tag generates a Form reset button.

If the src-attribute is specified, an image button is generated.

If the text-attribute is specified a text button is generated. The text button uses different background images for the left, middel and right part of the button.

The tag may only be used within a <forms:buttonsection>-tag.
../images/images/formbutton_small.gif

Tag class: FormResetTag
 

[ Syntax ]

Standard Syntax
<forms:reset
[ base = "Directory or Resource key" ]
[ buttonStyle = "String" ]
[ default = "boolean" ]
[ disabled = "boolean" ]
[ filter = "boolean" ]
[ height = "String" ]
[ locale = "String" ]
[ name = "String" ]
[ onblur = "String" ]
[ onchange = "String" ]
[ onclick = "String" ]
[ oncontextmenu = "String" ]
[ ondblclick = "String" ]
[ onfocus = "String" ]
[ onkeydown = "String" ]
[ onkeypress = "String" ]
[ onkeyup = "String" ]
[ onmousedown = "String" ]
[ onmousemove = "String" ]
[ onmouseout = "String" ]
[ onmouseover = "String" ]
[ onmouseup = "String" ]
[ permission = "ACL" ]
[ src = "String" ]
[ style = "String" ]
[ styleClass = "String" ]
[ styleId = "String" ]
[ tabindex = "Integer" ]
[ text = "String" ]
[ title = "String" ]
[ width = "String" ]
/>
 

[ Attributes ]

AttributeTypeDescriptionReq.RTExp
baseDirectory or Resource key Sets the base directory for a resource. The resource name will be prefixed with the name of the base directory. With localization enabled the value of the base attribute will be translated with the value stored in the ApplicationProperties.properties file.  
buttonStyleString Specifies an optional background image for the button. The images must be registerd in the ResourceMap.  
defaultboolean With this attribute, we can determine whether the button should send the form when the Return button is pressed.

Annotation: Note: In a form, only one button can be configured as the default button.

 
disabledboolean This attribute can be used to disable the control element. It then does not accept any user inputs and does not generate any control element events.  
filterboolean The automatic HTML coding of the element can be activated or disabled with the filter-attribute.  
heightString Sets the height of the form element. The height may be specified in absolute or percent terms.

Annotation: See HTML documentation for the attribute height.

 
localeString enables localization for the control element. String literals will be interpreted as keys in the Application.properties file.

Annotation: boolean value true oder false oder the name of a locale.

 
nameString Specifies the name of the Java-Bean. The Java-Bean must be stored in the given scope.

When the tag is surrounded by a Struts <html:form> tag, no Bean Name need be specified. In this case, the Java-Bean is drawn via a property of the Struts Form Bean.

Annotation: A valid Java identifier must be given.

 
onblurString Fires when the object loses the input focus.

Annotation: JavaScript Code

 
onchangeString Fires when the contents of the object or selection have changed.

Annotation: JavaScript Code

 
onclickString Fires when the user clicks the left mouse button on the object.

Annotation: JavaScript Code

 
oncontextmenuString Fires when the user clicks the right mouse button in the client area, opening the context menu.

Annotation: JavaScript Code

 
ondblclickString Fires when the user double-clicks the object.

Annotation: JavaScript Code

 
onfocusString Fires when the object receives focus.

Annotation: JavaScript Code

 
onkeydownString Fires when the user presses a key.

Annotation: JavaScript Code

 
onkeypressString Fires when the user presses an alphanumeric key.

Annotation: JavaScript Code

 
onkeyupString Fires when the user releases a key.

Annotation: JavaScript Code

 
onmousedownString Fires when the user clicks the object with either mouse button.

Annotation: JavaScript Code

 
onmousemoveString Fires when the user moves the mouse over the object.

Annotation: JavaScript Code

 
onmouseoutString Fires when the user moves the mouse pointer outside the boundaries of the object.

Annotation: JavaScript Code

 
onmouseoverString Fires when the user moves the mouse pointer into the object.

Annotation: JavaScript Code

 
onmouseupString Fires when the user releases a mouse button while the mouse is over the object.

Annotation: JavaScript Code

 
permissionACL With this attribute, access to the element can be restricted.

Authorizations are checked using the com.cc.framework.security.Principal object in the user session. The principal object is registered in the session with the method com.cc.framework.security.SecurityUtil#registerPrincipal(HttpSession, Principal). It is made available by the application developer by implementing the principal interface. In this manner, any authorization system can be very easily connected within the framework.

Authorizations are always specified in the form of an Access Control List (ACL). What is involved here is a semicolon-delimited list with individual authorizations. The framweork supports the following authorization types, which, however, can be expanded at will by the application developer:

Literal
true|false -> com.cc.framework.security.StaticPermission
Role
#rolename -> com.cc.framework.security.RoleBasedPermission
Function
$functionname -> com.cc.framework.security.FunctionBasedPermission

 
srcString Specifies the name of the Image Resource with the button image.

Name convention: The framework provides a mechanism for automatic image exchange when certain mouse events take place. In order that the mechanism can be used, the following rules apply:

  • The name of the button (specified in the name-attribute) must start with the prefix btn.
  • The filename of the gif image used must have the following format: xxxxxxxN.gif. where <N> stands for the button state.
A distinction is made between the following button states:
  • 1 = active (normal)
  • 2 = inactive (disabled)
  • 3 = hover (mouse over the button)
  • 4 = pressed

 
styleString An HTML-style can be directly specified with this attribute.

Annotation: See HTML documentation for the attribute style.

 
styleClassString The HTML-class attribute of the element can be specified with this attribute.

Annotation: See HTML documentation for the Attribute class.

 
styleIdString The HTML-id attribute of the element can be specified with this attribute.

Annotation: See HTML documentation for the Attribute id.

 
tabindexInteger Tabulator Index for this element.  
textString The localized caption of the button. If this attribute is specified the button is rendered as a text button.  
titleString Is displayed in a Tooltip window when the user moves the mouse over the button.  
widthString Sets the width of the form element. The width may be specified in absolute or percent terms.

Annotation: See HTML documentation for the attribute width.

 

[ Example ]

Form element with a button.


<%@ taglib uri="http://www.common-controls.com/cc/tags-forms"   prefix="forms" %>

<forms:form  type="search"  caption="Currency Search"  formid="frmSearch">
    <forms:buttonsection>
        <forms:reset  name="btnReset"  src="images/buttons/btnReset1.gif"/>
    </forms:buttonsection>
</forms:form>