`<ctrl:swapselect>`

Generates a select element with two list which allows to transfere elements from one list to the other list. The available elements will be specified by the <base:options>-Tag within the tag body. The data bean should provide an array which holds the selected elements.

../images/images/ctrlswapselect_small.gif

Body content: JSP
Tag class: SwapSelectTag

[ Syntax ]

Standard Syntax

<ctrl:swapselect

[ disabled = "boolean" ]
[ filter = "boolean" ]
[ hideButtons = "String list" ]
[ id = "String" ]
[ labelLeft = "String" ]
[ labelRight = "String" ]
[ moveButton = "" ]
[ multiple = "" ]
[ 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" ]
[ orientation = "{horizontal | vertical}" ]
[ property = "String" ]
[ retainOrder = "" ]
[ runat = "{server | client | auto}" ]
[ scope = "{any | page | request | session | application}" ]
[ size = "Integer" ]
[ sortOrder = "{none | asc | desc}" ]
[ style = "String" ]
[ styleId = "String" ]
[ summary = "String" ]
[ tabindex = "Integer" ]
[ tooltip = "String" ]
[ transaction = "Boolean" ]
[ value = "String" ]
>
...Body Content...

</ctrl:swapselect>

[ Attributes ]

Attribute	Type	Description	Req.	RTExp
disabled	boolean	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.
filter	boolean	The automatic HTML coding of the column contents can be activated or disabled with the filter-attribute.
hideButtons	String list	This attribute can be used to hide some of the buttons. The buttons needs to be specified within a semicolon separated list. Annotation: A semicolon separated list. The button names must match values of ControlButton.getName()
id	String	The name of a page scope JSP bean that will contain the current element. Using the given Id, the variable can be accessed in scripting expressions in the tag Body. The id mus be a string lteral because the JSP compiler generates a variable withthis name at compile time Annotation: A valid Java identifier must be given.
labelLeft	String	Specifies the label for the left or upper list.
labelRight	String	Specifies the label for the right or lower list.
moveButton
multiple
name	String	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.
onblur	String	Fires when the object loses the input focus. Annotation: JavaScript Code
onchange	String	Fires when the contents of the object or selection have changed. Annotation: JavaScript Code
onclick	String	Fires when the user clicks the left mouse button on the object. Annotation: JavaScript Code
oncontextmenu	String	Fires when the user clicks the right mouse button in the client area, opening the context menu. Annotation: JavaScript Code
ondblclick	String	Fires when the user double-clicks the object. Annotation: JavaScript Code
onfocus	String	Fires when the object receives focus. Annotation: JavaScript Code
onkeydown	String	Fires when the user presses a key. Annotation: JavaScript Code
onkeypress	String	Fires when the user presses an alphanumeric key. Annotation: JavaScript Code
onkeyup	String	Fires when the user releases a key. Annotation: JavaScript Code
onmousedown	String	Fires when the user clicks the object with either mouse button. Annotation: JavaScript Code
onmousemove	String	Fires when the user moves the mouse over the object. Annotation: JavaScript Code
onmouseout	String	Fires when the user moves the mouse pointer outside the boundaries of the object. Annotation: JavaScript Code
onmouseover	String	Fires when the user moves the mouse pointer into the object. Annotation: JavaScript Code
onmouseup	String	Fires when the user releases a mouse button while the mouse is over the object. Annotation: JavaScript Code
orientation	OrientationType	Specifies the alignment of the two lists. horizontal = Horizontal alignment (left to the right) vertical = Vertical alignment (top to the bottom)
property	String	Specifies the name of the property using which the Java-Bean is to be accessed. This is generally only necessary when the Java-Bean is associated with a Struts Form Bean. Annotation: A valid Java identifier must be given.
retainOrder
runat	RunAt	This attribute specifies whether, for the control element, Clientside JavaScript should be used, or whether the control element should work purely with Server Roundtrips. server = All control element actions result in a Server Roundtrip and are processed on the server. client = control element actions are carried out directly in the browser of the user. It depends on the Painter Factory used and the specific control element, how far the support for Clientside Scripting goes! auto = The framework selects based on the users browser settings "client" when JavaScript is enabled and "server" when JavaScript is disabled.
scope	HTTPScope	This attribute shows the Scope in which the Java-Bean with the actual display data can be found. any = The Bean is searched for in ever Scope. page = The Bean exists as a local variable in the JSP Page. request = The Bean is in the HTTP-Request. session = The Bean is in the HTTP-Session. application = The Bean is in the Servletkontext.
size	Integer	Specifies the number of visibel options.
sortOrder		none = asc = desc =
style	String	An HTML-style can be directly specified with this attribute. Annotation: See HTML documentation for the attribute style.
styleId	String	The HTML-id attribute of the element can be specified with this attribute. Annotation: See HTML documentation for the Attribute id.
summary	String	This property can be used for rendering to non-visual media such as speech or Braille.
tabindex	Integer	Tabulator Index for this element.
tooltip	String	A short descriptive text that is displayed when the user moves the mouse over the element. The character string is HTML-encoded before outputting.
transaction	Boolean	This flag directs the framework to append a transaction token to all generated hyperlinks. The transactio token allows the detection of form re-submissions (multiple submission of the same HTTP form).
value	String	This attribute sets the initial displayed value of the field if it displays a textual or numerical value. Annotation: See HTML documentation for the attribute value.

[ Example ]

The example shows the usage of the SwapControl within a ListControl.

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

<html:form action="sample153/listBrowse" method="post">
    <ctrl:list
        name="orders"
        title="orders"
        rows="5"
        refreshButton="true"
        formElement="true">

        <ctrl:columnhtml    title="detail"  id="detail"  editable="true"  width="250">
            <ctrl:swapselect
                property="selOptions"
                orientation="horizontal"
                labelLeft="form.label.books.left"
                labelRight="form.label.books.right"
                size="7"
                filter="false"
                runat="client"
                style="width: 100%"/>
        </ctrl:columnhtml>

    </ctrl:list>
</html:form>