The Common-Controls Tag Library

<base:innerframe>

The Tag creates a frame inside of a control. Within a list- or treelist-control a frame can be declared before or after the definition of the columns. This will display the frame within the header or footer of the control.
../images/images/innerframe_small.gif

Body content: JSP
Tag class: InnerFrameTag
 

[ Syntax ]

Standard Syntax
<base:innerframe
[ border = "Integer" ]
[ height = "String" ]
[ permission = "ACL" ]
[ summary = "String" ]
[ valign = "{top | bottom}" ]
[ width = "String" ]
>
...Body Content...

</base:innerframe>
 

[ Attributes ]

AttributeTypeDescriptionReq.RTExp
borderInteger Specifies the thickness of the border that has to be drawn around the control element.  
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.

 
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

 
summaryString This property can be used for rendering to non-visual media such as speech or Braille.  
valignAlignmentType Specifies the alignment of the frame within the embedded container.
  • top = Top alignment
  • bottom = Bottom alignment
 
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 ]

Frame inside a listcontrol


<%@ taglib uri="http://struts.apache.org/tags-html"             prefix="html" %>
<%@ taglib uri="http://www.common-controls.com/cc/tags-base"   prefix="base" %>
<%@ taglib uri="http://www.common-controls.com/cc/tags-ctrl"    prefix="ctrl" %>

<html:form action="sample102/carBrowse" method="post">

<ctrl:list
   styleId="carlist1"
   name="cars"
   title="car.list.title"
   width="465"
   rows="7"
   minRows="7"
   select="multiple"
   formElement="true">


   <base:innerframe border="false">
      Inner Frame 1 (no border)
   </base:innerframe>

   <ctrl:columncheck   property="checkState"    checkAll="true"                width="50"/>
   <ctrl:columntext          title="car.list.id"      property="id"         width="65"/>
   <ctrl:columntext   title="car.list.name"    property="name"      width="350"/>
   <ctrl:columntext   title="car.list.manuf"   property="manufacturerName"   width="150"/>

   <base:innerframe border="true">
      Inner Frame 2
   </base:innerframe>

</ctrl:list>

</html:form>