|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.wicket.Component org.apache.wicket.MarkupContainer org.apache.wicket.markup.html.WebMarkupContainer org.apache.wicket.markup.html.form.LabeledWebMarkupContainer org.apache.wicket.markup.html.form.FormComponent org.apache.wicket.markup.html.form.ListMultipleChoice
public class ListMultipleChoice
A multiple choice list component.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.apache.wicket.markup.html.form.FormComponent |
---|
FormComponent.AbstractVisitor, FormComponent.IVisitor |
Nested classes/interfaces inherited from class org.apache.wicket.Component |
---|
Component.ComponentModelChange, Component.EnabledChange, Component.VisibilityChange |
Field Summary |
---|
Fields inherited from class org.apache.wicket.markup.html.form.FormComponent |
---|
FLAG_CONVERT_EMPTY_INPUT_STRING_TO_NULL, VALUE_SEPARATOR |
Fields inherited from class org.apache.wicket.Component |
---|
ENABLE, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED6, FLAG_RESERVED7, FLAG_RESERVED8, PATH_SEPARATOR, RENDER |
Constructor Summary | |
---|---|
ListMultipleChoice(java.lang.String id)
|
|
ListMultipleChoice(java.lang.String id,
IModel choices)
|
|
ListMultipleChoice(java.lang.String id,
IModel choices,
IChoiceRenderer renderer)
|
|
ListMultipleChoice(java.lang.String id,
IModel model,
IModel choices)
|
|
ListMultipleChoice(java.lang.String id,
IModel model,
IModel choices,
IChoiceRenderer renderer)
|
|
ListMultipleChoice(java.lang.String id,
IModel object,
java.util.List choices)
|
|
ListMultipleChoice(java.lang.String id,
IModel object,
java.util.List choices,
IChoiceRenderer renderer)
|
|
ListMultipleChoice(java.lang.String id,
java.util.List choices)
|
|
ListMultipleChoice(java.lang.String id,
java.util.List choices,
IChoiceRenderer renderer)
|
|
ListMultipleChoice(java.lang.String id,
java.util.List choices,
int maxRows)
Creates a multiple choice list with a maximum number of visible rows. |
Method Summary | |
---|---|
protected void |
appendOptionHtml(AppendingStringBuffer buffer,
java.lang.Object choice,
int index,
java.lang.String selected)
Generates and appends html for a single choice into the provided buffer |
protected java.util.List |
convertChoiceIdsToChoices(java.lang.String[] ids)
Converts submitted choice ids to choice objects. |
protected java.lang.Object |
convertValue(java.lang.String[] ids)
Subclasses should overwrite this if the conversion is not done through the type field and the IConverter. |
protected void |
detachModel()
Detaches the model for this component if it is detachable. |
protected java.lang.CharSequence |
escapeOptionHtml(java.lang.String displayValue)
Method to override if you want special escaping of the options html. |
IChoiceRenderer |
getChoiceRenderer()
|
java.util.List |
getChoices()
|
protected java.lang.CharSequence |
getDefaultChoice(java.lang.Object selected)
|
protected static int |
getDefaultMaxRows()
Gets the default maximum number of rows to display. |
java.lang.String |
getModelValue()
|
protected boolean |
isDisabled(java.lang.Object object,
int index,
java.lang.String selected)
Gets whether the given value is disabled. |
protected boolean |
isSelected(java.lang.Object choice,
int index,
java.lang.String selected)
Gets whether the given value represents the current selection. |
protected boolean |
localizeDisplayValues()
Override this method if you want to localize the display values of the generated options. |
protected void |
onComponentTag(ComponentTag tag)
Processes the component tag. |
protected void |
onComponentTagBody(MarkupStream markupStream,
ComponentTag openTag)
Handle the container's body. |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoiceRenderer(IChoiceRenderer renderer)
Set the choice renderer to be used. |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoices(IModel choices)
Sets the list of choices |
org.apache.wicket.markup.html.form.AbstractChoice |
setChoices(java.util.List choices)
Sets the list of choices. |
protected static void |
setDefaultMaxRows(int defaultMaxRows)
Sets the default maximum number of rows to display. |
ListMultipleChoice |
setMaxRows(int maxRows)
Sets the number of visible rows in the listbox. |
protected boolean |
supportsPersistence()
|
void |
updateModel()
If the model object exists, it is assumed to be a Collection, and it is modified in-place. |
Methods inherited from class org.apache.wicket.markup.html.form.FormComponent |
---|
add, checkRequired, clearInput, convertInput, error, getBehaviors, getConvertedInput, getForm, getInput, getInputAsArray, getInputName, getRawInput, getType, getValidatorKeyPrefix, getValidators, getValue, hasRawInput, inputAsInt, inputAsInt, inputAsIntArray, inputChanged, internalOnModelChanged, invalid, isInputNullable, isMultiPart, isPersistent, isRequired, isValid, onDetach, onDisabled, onInvalid, onValid, processChildren, processInput, setConvertedInput, setLabel, setModelValue, setModelValue, setPersistent, setRequired, setType, shouldTrimInput, trim, valid, validate, validateRequired, validateValidators, visitFormComponentsPostOrder |
Methods inherited from class org.apache.wicket.markup.html.form.LabeledWebMarkupContainer |
---|
getLabel, setLabelInternal |
Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer |
---|
getMarkupType, getWebPage |
Methods inherited from class org.apache.wicket.MarkupContainer |
---|
add, addOrReplace, autoAdd, autoAdd, contains, findMarkupStream, get, getAssociatedMarkupStream, getMarkupStream, hasAssociatedMarkup, internalAdd, isTransparentResolver, iterator, iterator, newMarkupResourceStream, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, replace, setMarkupStream, setModel, size, toString, toString, visitChildren, visitChildren |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public ListMultipleChoice(java.lang.String id)
AbstractChoice.AbstractChoice(String)
public ListMultipleChoice(java.lang.String id, java.util.List choices)
AbstractChoice.AbstractChoice(String, List)
public ListMultipleChoice(java.lang.String id, java.util.List choices, int maxRows)
id
- component idchoices
- list of choicesmaxRows
- the maximum number of visible rows.AbstractChoice.AbstractChoice(String, List)
public ListMultipleChoice(java.lang.String id, java.util.List choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String,
List,IChoiceRenderer)
public ListMultipleChoice(java.lang.String id, IModel object, java.util.List choices)
AbstractChoice.AbstractChoice(String, IModel, List)
public ListMultipleChoice(java.lang.String id, IModel object, java.util.List choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String, IModel,
List,IChoiceRenderer)
public ListMultipleChoice(java.lang.String id, IModel choices)
AbstractChoice.AbstractChoice(String, IModel)
public ListMultipleChoice(java.lang.String id, IModel model, IModel choices)
AbstractChoice.AbstractChoice(String, IModel,IModel)
public ListMultipleChoice(java.lang.String id, IModel choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String,
IModel,IChoiceRenderer)
public ListMultipleChoice(java.lang.String id, IModel model, IModel choices, IChoiceRenderer renderer)
AbstractChoice.AbstractChoice(String, IModel,
IModel,IChoiceRenderer)
Method Detail |
---|
protected static int getDefaultMaxRows()
protected static void setDefaultMaxRows(int defaultMaxRows)
defaultMaxRows
- The defaultMaxRows to set.public final ListMultipleChoice setMaxRows(int maxRows)
maxRows
- the number of visible rows
public final java.lang.String getModelValue()
getModelValue
in class FormComponent
FormComponent.getModelValue()
protected final boolean isSelected(java.lang.Object choice, int index, java.lang.String selected)
choice
- The object to checkindex
- The index in the choices collection this object is in.selected
- The currently selected string value
AbstractChoice.isSelected(Object,int, String)
protected void onComponentTag(ComponentTag tag)
FormComponent
onComponentTag
in class FormComponent
tag
- Tag to modifyComponent.onComponentTag(ComponentTag)
protected java.lang.Object convertValue(java.lang.String[] ids) throws ConversionException
FormComponent
convertValue
in class FormComponent
ids
- The value can be the getInput() or through a cookie
ConversionException
- If input can't be convertedFormComponent.convertValue(String[])
protected java.util.List convertChoiceIdsToChoices(java.lang.String[] ids)
ids
- choice ids. this array is nonnull and always contains at least one id.
public void updateModel()
Model.setObject(Object)
is called with the same instance: it allows the Model to
be notified of changes even when Model.getObject()
returns a different
Collection
at every invocation.
updateModel
in class FormComponent
java.lang.UnsupportedOperationException
- if the model object Collection cannot be modifiedFormComponent.updateModel()
public java.util.List getChoices()
public final org.apache.wicket.markup.html.form.AbstractChoice setChoices(IModel choices)
choices
- model representing the list of choices
public final org.apache.wicket.markup.html.form.AbstractChoice setChoices(java.util.List choices)
choices
- the list of choices
public final IChoiceRenderer getChoiceRenderer()
public final org.apache.wicket.markup.html.form.AbstractChoice setChoiceRenderer(IChoiceRenderer renderer)
renderer
-
protected void detachModel()
Component
detachModel
in class Component
Component.detachModel()
protected java.lang.CharSequence getDefaultChoice(java.lang.Object selected)
selected
- The object that's currently selected
protected boolean isDisabled(java.lang.Object object, int index, java.lang.String selected)
object
- The object to checkindex
- The index in the choices collection this object is in.selected
- The currently selected string value
protected void onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)
onComponentTagBody
in class MarkupContainer
markupStream
- The markup streamopenTag
- The open tag for the bodyComponent.onComponentTagBody(MarkupStream, ComponentTag)
protected void appendOptionHtml(AppendingStringBuffer buffer, java.lang.Object choice, int index, java.lang.String selected)
buffer
- Appending string buffer that will have the generated html appendedchoice
- Choice objectindex
- The index of this optionselected
- The currently selected string valueprotected java.lang.CharSequence escapeOptionHtml(java.lang.String displayValue)
displayValue
-
protected boolean supportsPersistence()
supportsPersistence
in class FormComponent
FormComponent.supportsPersistence()
protected boolean localizeDisplayValues()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |