org.opencms.widgets

Interface I_CmsWidgetParameter

All Known Implementing Classes:

A_CmsXmlContentValue, A_CmsXmlValueCdataBase, A_CmsXmlValueTextBase, CmsXmlBooleanValue, CmsXmlCategoryValue, CmsXmlColorValue, CmsXmlDateTimeValue, CmsXmlDisplayFormatterValue, CmsXmlDynamicCategoryValue, 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

Method Summary

Modifier and Type	Method and Description
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