Class DefaultReferenceUIEditor

    • Field Detail

      • AUTOCOMPLETION_SEARCHTYPE

        public static final java.lang.String AUTOCOMPLETION_SEARCHTYPE
        See Also:
        Constant Field Values
    • Constructor Detail

      • DefaultReferenceUIEditor

        public DefaultReferenceUIEditor()
      • DefaultReferenceUIEditor

        public DefaultReferenceUIEditor​(ObjectType rootType)
    • Method Detail

      • setRootType

        public void setRootType​(ObjectType rootType)
        Description copied from interface: ReferenceUIEditor
        Sets the root type of this reference editor i.e. the root type of the references which this editor holds.
        Parameters:
        rootType - the root type
      • setAutocompletionSearchType

        public void setAutocompletionSearchType​(ObjectType autocompletionSearchType)
      • createViewComponent

        public org.zkoss.zk.ui.HtmlBasedComponent createViewComponent​(java.lang.Object initialValue,
                                                                      java.util.Map<java.lang.String,​? extends java.lang.Object> parameters,
                                                                      EditorListener listener)
        Description copied from interface: UIEditor
        Creates a new editor component and attaches it to the specified Page page.
        Parameters:
        initialValue - editor's initial value
        parameters - parameters passed via configuration for particular editor
        listener - the EditorListener that will receive events when the editor's value is changed
        Returns:
        the editor component
      • getValue

        public java.lang.Object getValue()
        Description copied from interface: UIEditor
        Returns the value held by this editor.
        Specified by:
        getValue in interface UIEditor
        Overrides:
        getValue in class AbstractUIEditor
        Returns:
        this editor's value
      • isInline

        public boolean isInline()
        Description copied from interface: UIEditor
        Returns whether this editor is an inline editor or not.
        Returns:
        true, if inline
      • setValue

        public void setValue​(java.lang.Object value)
        Description copied from interface: UIEditor
        Sets the value of this editor to value.

        Note: Does not have anything to do with value persistence, it is only for setting the value to be displayed. However, depending on the view component implementation and the specified EditorListener the underlying view component might generate an event which causes the EditorListener.valueChanged(Object) method to be called.

        Specified by:
        setValue in interface UIEditor
        Overrides:
        setValue in class AbstractUIEditor
        Parameters:
        value - the value to set
      • setFocus

        public void setFocus​(org.zkoss.zk.ui.HtmlBasedComponent rootEditorComponent,
                             boolean selectAll)
        Description copied from interface: UIEditor
        Sets the focus on the given input component which can be the rootEditorComponent or a child of it
        Specified by:
        setFocus in interface UIEditor
        Overrides:
        setFocus in class AbstractUIEditor
        Parameters:
        rootEditorComponent - the rootEditorComponent which is returned on method createViewComponent
        selectAll - if true, select the whole input field after focus. It is not guaranteed that the editor supports selection.
      • getRootSearchType

        public ObjectType getRootSearchType()
        Description copied from interface: ReferenceUIEditor
        Returns the type for which this reference collection editor should search for.

        Generally, if no root search type has been explicitly set, this method returns the same type as ReferenceUIEditor.getRootType().

        Note: The root search type is actually the type of the items held by this editor, whereas root type is the type which should be used for persisting values.
        Returns:
        the type for which this reference collection editor should search for
        See Also:
        ReferenceUIEditor.getRootType()
      • getRootType

        public ObjectType getRootType()
        Description copied from interface: ReferenceUIEditor
        Returns the root type of this reference collection editor i.e. the type of the items which this editor should hold references to.

        Note: If the root search type differs from the root type, this editor will actually hold items of the type returned by ReferenceUIEditor.getRootSearchType(). In this case information about the root type is generally needed for value handling.

        Returns:
        the root type of this editor
        See Also:
        ReferenceUIEditor.getRootSearchType()
      • parseInitialParameters

        protected void parseInitialParameters​(java.util.Map<java.lang.String,​? extends java.lang.Object> parameters)