org.opencms.widgets
Interface I_CmsWidgetParameter

All Known Implementing Classes:
A_CmsXmlContentValue, A_CmsXmlValueCdataBase, A_CmsXmlValueTextBase, CmsWidgetDialogParameter, CmsXmlBooleanValue, CmsXmlColorValue, CmsXmlDateTimeValue, CmsXmlHtmlValue, CmsXmlLocaleValue, CmsXmlNestedContentDefinition, CmsXmlPlainTextStringValue, CmsXmlStringValue, CmsXmlVarLinkValue, CmsXmlVfsFileValue, CmsXmlVfsImageValue

public interface I_CmsWidgetParameter

Parameter value wrapper used by the OpenCms workplace widgets.

Since:
6.0.0
Version:
$Revision: 1.10 $
Author:
Alexander Kandzior

Method Summary
 java.lang.String getDefault(CmsObject cms)
          Returns the default value of this parameter.
 java.lang.String getId()
          Returns the form id of this parameter.
 int getIndex()
          Returns the index of this widget parameter, starting with 0.
 java.lang.String getKey()
          Returns the localized key identificator of this parameter.
 int getMaxOccurs()
          Returns the maximum occurences of this parameter.
 int getMinOccurs()
          Returns the minimum occurences of this parameter.
 java.lang.String getName()
          Returns the name of this parameter.
 java.lang.String getStringValue(CmsObject cms)
          Returns the value of this parameter.
 boolean hasError()
          Returns true if this widgets value contains an error.
 void setKeyPrefix(java.lang.String prefix)
          Sets an optional localized key prefix identificator of this parameter.
 void setStringValue(CmsObject cms, java.lang.String value)
          Sets the value of this parameter.
 

Method Detail

getDefault

java.lang.String getDefault(CmsObject cms)
Returns the default value of this parameter.

If no default value has been provided, null is returned.

Parameters:
cms - an initialized instance of an OpenCms user context
Returns:
the default value of this parameter

getId

java.lang.String getId()
Returns the form id of this parameter.

Returns:
the form id of this parameter

getIndex

int getIndex()
Returns the index of this widget parameter, starting with 0.

This is usefull in case there are more then one parameters with the same name, for example when creating a list of parameters of the same type.

Returns:
the index of this widget parameter

getKey

java.lang.String getKey()
Returns the localized key identificator of this parameter.

Returns:
the localized key identificator of this parameter

getMaxOccurs

int getMaxOccurs()
Returns the maximum occurences of this parameter.

Returns:
the maximum occurences of this parameter

getMinOccurs

int getMinOccurs()
Returns the minimum occurences of this parameter.

Returns:
the minimum occurences of this parameter

getName

java.lang.String getName()
Returns the name of this parameter.

Returns:
the name of this parameter

getStringValue

java.lang.String getStringValue(CmsObject cms)
Returns the value of this parameter.

Parameters:
cms - an initialized instance of an OpenCms user context
Returns:
the value of this parameter

hasError

boolean hasError()
Returns true if this widgets value contains an error.

Returns:
true if this widgets value contains an error

setKeyPrefix

void setKeyPrefix(java.lang.String prefix)
Sets an optional localized key prefix identificator of this parameter.

Parameters:
prefix - the optional localized key prefix identificator of this parameter

setStringValue

void setStringValue(CmsObject cms,
                    java.lang.String value)
Sets the value of this parameter.

This method does provide processing of the content based on the users current OpenCms context. This can be used e.g. for link extraction and replacement in the content.

Parameters:
cms - an initialized instance of an OpenCms user context
value - the value to set