Class FWAbstractFormComponent
java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
net.simplace.pipe.formcomponents.FWAbstractFormComponent
- All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible, net.simplace.core.FWBusyIndicator, net.simplace.core.FWObserver
- Direct Known Subclasses:
FWAbstractExtendedFormComponent, FWCalibrationFormComponent, FWChartFormComponent, FWChoiceFormComponent, FWDateFormComponent, FWDoubleFormComponent, FWFileChooserFormComponent, FWGroupFormComponent, FWImageFormComponent, FWIntegerFormComponent, FWLabelFormComponent, FWMemoryMonitorFormComponent, FWProcessorButtonFormComponent, FWResultFormComponent, FWTextFormComponent
public abstract class FWAbstractFormComponent
extends JPanel
implements net.simplace.core.FWObserver, net.simplace.core.FWBusyIndicator
Base class of the form components shown in a form panel. A component is described by its form element
(attributes
title, required, enabled, visible,
captionLocation (north, east, south, invisible; default west), default,
requiredWarning; child elements as parameters, e.g. formFiller,
formFiller.contentfield, formFiller.jumper; optional configuration
element). The attributes may contain parameter tokens.
The component observes the parameters of the functionality: when a parameter used in enabled,
visible, default or the form filler jumper rule changes, the component is updated.
Implementations must call notifyDependentComponents() whenever their value changes, so that other
components are informed.
Components can be detachable (see the DETACH_* constants): they then get buttons to copy, print,
export and detach their content into a separate window.
- Author:
- Andreas Enders, Christoph Kunze
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class JPanel
JPanel.AccessibleJPanelNested classes/interfaces inherited from class JComponent
JComponent.AccessibleJComponentNested classes/interfaces inherited from class Container
Container.AccessibleAWTContainerNested classes/interfaces inherited from class Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconstatic final intComponent detaches automatically while opening the formstatic final intComponent shows only a frame - while klicking the frame is extended and outpoped.static final intDefault! Component looks and behaves as any other componentstatic final intComponent detaches automatically while opening the form, but stays linkedstatic final intComponent is to be detachableprotected static final Colorprotected static final Colorprotected static final intprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconprotected JPanelprotected net.simplace.core.FWObservableprotected static final ImageIconprotected static final ImageIconprotected static final ImageIconFields inherited from class JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWFields inherited from class Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTFields inherited from interface net.simplace.core.FWBusyIndicator
BUSY_STEPSFields inherited from interface ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedCreates an uninitialised component;init(String, String, boolean, int, Element, FWObservable)has to be called by the implementation.protectedFWAbstractFormComponent(String aFormID, String aFieldID, boolean aShowLabel, int aDetachable, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) protectedFWAbstractFormComponent(String aFormID, String aFieldID, boolean aShowLabel, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) Creates a non-detachable component. -
Method Summary
Modifier and TypeMethodDescriptionvoidAdds a component without scroll bar (seeadd(Component, Object, boolean)).voidAdds a component.voidattachPanel(FWDetachFrame aDetachFrame) Moves the content of a detach window back into the component.voidCalled when the form is closed: disposes the open detach windows.protected voidcreateDetachControls(JPanel aContentPanel) Creates the header with the copy, print, export and detach buttons and the mouse handling (highlighting, button actions; a click elsewhere detaches the content).voiddetachPanel(boolean aUpdateContent) Moves the content into a separate window (if the component is detachable) and shows a placeholder in the form; forDETACH_AUTOandDETACH_LINKEDthe window stays on top.voiddisposePanel(FWDetachFrame aDetachFrame) Closes a detach window without moving its content back.protected voidCalled by the export button of detachable components; to be overridden by components that support export.com.lowagie.text.Rectangle[]getCells(int aType) Creates the iText cells for printing or exporting the form: caption cell and value cell, or a value cell spanning two columns if no caption is shown.protected Stringprotected org.jdom2.Elementintorg.jdom2.Elementprotected FWAbstractFormComponentFillerprotected Stringprotected Stringprotected StringgetLocaleValue(String aKey) Reads a localised text<locale prefix>.FormComponent.<key>from the locale bundle of the system (LocaleBundle_<SYSTEM_ID>, orLocaleBundle).protected StringgetLocaleValue(String aKey, String aDefault) Reads a localised text<locale prefix>.FormComponent.<key>from the locale bundle of the system (LocaleBundle_<SYSTEM_ID>, orLocaleBundle).net.simplace.core.FWObservableprotected StringgetTitle()abstract ObjectgetValue()protected abstract com.lowagie.text.RectanglegetValueCell(int aType) Returns the value cell used for generating the RTF, PDF or HTML version of the form.protected booleanprotected booleanvoidhideBusy()Restores the default cursor.protected voidinit(String aFormID, String aFieldID, boolean aShowLabel, int aDetachable, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) Initialises the component: reads the attributes of the form element, sets up the detach controls and the caption label (wrapped to the label width), instantiates the form filler (parameterformFiller, oldde.isdss.util.framework.ui.form.filler.class names are mapped) and callsprocessFormFiller(), and sets the visibility.booleanbooleanbooleanprotected voidUpdates the functionalities' parameter map with the current value of this control so other form components that observe the parameter map get notified.abstract voidFills the component from its form filler (e.g.voidRemoves a component; for detachable components content is removed from the detach panel (DETACH_BUTTON: ignored).protected voidsetConfiguration(String aClassname, org.jdom2.Element aConfigurationElement) Adds a configuration element to the form element.voidSets the value to the attributedefault(tokens replaced), if given.protected voidsetDetachControlsEnabled(boolean aEnabled) Sets the enabled state of the detach button to aEnabled and clears the highlighted state if aEnabled is false.protected voidsetDetachControlsHighlighted(boolean aHighlighted) Makes the detach button and related controls appear highlighted or not (no effect while they are disabled).voidsetFieldID(String aFieldID) voidsetFormElement(org.jdom2.Element aFormElement) voidvoidsetObservable(net.simplace.core.FWObservable aObservable) voidsetRequired(boolean aRequiredness) Sets whether the component is required; has no effect if the attributerequiredis set.voidSets the title and updates the caption label.protected voidsetUpDetachControl(int aDetachability) Sets the detachability and, for detachable components, creates the detach panel with its controls.abstract voidvoidshowBusy(int aStep) Shows the progress cursor of the given step while the parameters notify their observers.toString()voidReacts to a changed parameter: re-evaluatesenabledandvisible(a disabled or hidden component is reset to its default), resets the default value and re-runs the form filler, if the changed parameter is used in them.Methods inherited from class JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUIMethods inherited from class JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateMethods inherited from class Container
add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTreeMethods inherited from class Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
iObservable
protected net.simplace.core.FWObservable iObservable -
iDetachContentPanel
-
DETACH_TRUE
public static final int DETACH_TRUEComponent is to be detachable- See Also:
-
DETACH_FALSE
public static final int DETACH_FALSEDefault! Component looks and behaves as any other component- See Also:
-
DETACH_AUTO
public static final int DETACH_AUTOComponent detaches automatically while opening the form- See Also:
-
DETACH_BUTTON
public static final int DETACH_BUTTONComponent shows only a frame - while klicking the frame is extended and outpoped.- See Also:
-
DETACH_LINKED
public static final int DETACH_LINKEDComponent detaches automatically while opening the form, but stays linked- See Also:
-
DETATCH_BORDER_WIDTH
protected static final int DETATCH_BORDER_WIDTH- See Also:
-
DETATCH_BORDER_DEFAULT_COLOR
-
DETATCH_BORDER_HIGHLIGHT_COLOR
-
DETATCH_BUTTON_DEFAULT_IMAGE
-
DETATCH_BUTTON_HIGHLIGHT_IMAGE
-
DETATCH_BUTTON_DISABLED_IMAGE
-
PRINT_BUTTON_DEFAULT_IMAGE
-
PRINT_BUTTON_HIGHLIGHT_IMAGE
-
PRINT_BUTTON_DISABLED_IMAGE
-
COPY_BUTTON_DEFAULT_IMAGE
-
COPY_BUTTON_HIGHLIGHT_IMAGE
-
COPY_BUTTON_DISABLED_IMAGE
-
EXPORT_BUTTON_DEFAULT_IMAGE
-
EXPORT_BUTTON_HIGHLIGHT_IMAGE
-
EXPORT_BUTTON_DISABLED_IMAGE
-
-
Constructor Details
-
FWAbstractFormComponent
protected FWAbstractFormComponent()Creates an uninitialised component;init(String, String, boolean, int, Element, FWObservable)has to be called by the implementation. -
FWAbstractFormComponent
protected FWAbstractFormComponent(String aFormID, String aFieldID, boolean aShowLabel, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) Creates a non-detachable component.- Parameters:
aFormID- id of the form the component is placed inaFieldID- id of the component, unique within the form; also the parameter key of its valueaShowLabel-trueto show a caption label;falsefor use in tablesaFormElement- the form element describing the componentaObservable- parameters of the functionality
-
FWAbstractFormComponent
protected FWAbstractFormComponent(String aFormID, String aFieldID, boolean aShowLabel, int aDetachable, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) - Parameters:
aFormID- id of the form the component is placed inaFieldID- id of the component, unique within the form; also the parameter key of its valueaShowLabel-trueto show a caption label;falsefor use in tablesaDetachable- detachability, one of theDETACH_*constantsaFormElement- the form element describing the componentaObservable- parameters of the functionality
-
-
Method Details
-
init
protected void init(String aFormID, String aFieldID, boolean aShowLabel, int aDetachable, org.jdom2.Element aFormElement, net.simplace.core.FWObservable aObservable) Initialises the component: reads the attributes of the form element, sets up the detach controls and the caption label (wrapped to the label width), instantiates the form filler (parameterformFiller, oldde.isdss.util.framework.ui.form.filler.class names are mapped) and callsprocessFormFiller(), and sets the visibility.- Parameters:
aFormID- id of the form the component is placed inaFieldID- id of the component, unique within the form; also the parameter key of its valueaShowLabel-trueto show a caption label;falsefor use in tablesaDetachable- detachability, one of theDETACH_*constantsaFormElement- the form element describing the component, ornullaObservable- parameters of the functionality
-
setUpDetachControl
protected void setUpDetachControl(int aDetachability) Sets the detachability and, for detachable components, creates the detach panel with its controls.- Parameters:
aDetachability- one of theDETACH_*constants
-
getValue
- Returns:
- value of the implemented component
-
setValue
- Parameters:
aValue- the new value of the component
-
processFormFiller
public abstract void processFormFiller()Fills the component from its form filler (e.g. options or a chart); called after initialisation and whenever the jumper rule of the form filler changes. -
getFieldID
- Returns:
- field id of the implemented component
-
setFormID
- Parameters:
aFormID- id of the form the component is placed in
-
getFormID
- Returns:
- form id of the implemented component
-
setFieldID
- Parameters:
aFieldID- id of the component, also the parameter key of its value
-
getFormElement
public org.jdom2.Element getFormElement()- Returns:
- the formElement
-
getOriginalComponentParameteterValue
-
getComponentParameteterValue
-
isRequired
public boolean isRequired()- Returns:
trueif the attributerequired(JEXL expression) is true
-
setRequired
public void setRequired(boolean aRequiredness) Sets whether the component is required; has no effect if the attributerequiredis set.- Parameters:
aRequiredness-trueif a value is required
-
isEnabled
-
notifyDependentComponents
protected void notifyDependentComponents()Updates the functionalities' parameter map with the current value of this control so other form components that observe the parameter map get notified. ImplementationsMUST call this function, whenever their value changes. -
getConfiguration
protected org.jdom2.Element getConfiguration()- Returns:
- the
configurationchild of the form element, ornull
-
setConfiguration
Adds a configuration element to the form element.- Parameters:
aClassname- not usedaConfigurationElement- the configuration element
-
hasConfiguration
protected boolean hasConfiguration()- Returns:
trueif the form element has aconfigurationchild
-
getLocaleValue
Reads a localised text<locale prefix>.FormComponent.<key>from the locale bundle of the system (LocaleBundle_<SYSTEM_ID>, orLocaleBundle).- Parameters:
aKey- key of the textaDefault- text returned if the key is missing- Returns:
- the localised text
-
getLocaleValue
Reads a localised text<locale prefix>.FormComponent.<key>from the locale bundle of the system (LocaleBundle_<SYSTEM_ID>, orLocaleBundle).- Parameters:
aKey- key of the text- Returns:
- the localised text; without main frame the part of the key after the first dot
-
getPreferredSize
- Overrides:
getPreferredSizein classJComponent
-
getMaximumSize
- Overrides:
getMaximumSizein classJComponent
-
exportData
protected void exportData()Called by the export button of detachable components; to be overridden by components that support export. The default only logs a warning. -
update
Reacts to a changed parameter: re-evaluatesenabledandvisible(a disabled or hidden component is reset to its default), resets the default value and re-runs the form filler, if the changed parameter is used in them. Changes of the component's own value are ignored.- Specified by:
updatein interfacenet.simplace.core.FWObserver- Parameters:
aObservable- the parametersaKeyOfParameterChanged- key of the changed parameter
-
hasFormFiller
protected boolean hasFormFiller()- Returns:
trueif a form filler was instantiated
-
getFormFiller
- Returns:
- the form filler, or
null
-
getJumper
- Returns:
- the jumper rule of the form filler with tokens replaced (the key passed to the filler), or the raw rule if not yet evaluated
-
getJumperRule
- Returns:
- the raw jumper rule (parameter
formFiller.jumper), ornull
-
getObservable
public net.simplace.core.FWObservable getObservable()- Returns:
- the parameters of the functionality
-
setObservable
public void setObservable(net.simplace.core.FWObservable aObservable) - Parameters:
aObservable- the parameters of the functionality
-
setFormElement
public void setFormElement(org.jdom2.Element aFormElement) - Parameters:
aFormElement- the form element describing the component
-
getDetachability
public int getDetachability()- Returns:
- the detachability, one of the
DETACH_*constants
-
createDetachControls
Creates the header with the copy, print, export and detach buttons and the mouse handling (highlighting, button actions; a click elsewhere detaches the content).- Parameters:
aContentPanel- not used
-
attachPanel
Moves the content of a detach window back into the component.- Parameters:
aDetachFrame- the detach window
-
disposePanel
Closes a detach window without moving its content back.- Parameters:
aDetachFrame- the detach window
-
detachPanel
public void detachPanel(boolean aUpdateContent) Moves the content into a separate window (if the component is detachable) and shows a placeholder in the form; forDETACH_AUTOandDETACH_LINKEDthe window stays on top.- Parameters:
aUpdateContent-trueto update the first existing detach window (a new one is opened if there is none),falseto open a new one
-
setDetachControlsHighlighted
protected void setDetachControlsHighlighted(boolean aHighlighted) Makes the detach button and related controls appear highlighted or not (no effect while they are disabled).- Parameters:
aHighlighted-trueto highlight
-
setDetachControlsEnabled
protected void setDetachControlsEnabled(boolean aEnabled) Sets the enabled state of the detach button to aEnabled and clears the highlighted state if aEnabled is false. To query the enabled state, use the isEnabled method of iDetachButton!- Parameters:
aEnabled-trueto enable the detach controls
-
remove
-
add
Adds a component without scroll bar (seeadd(Component, Object, boolean)). -
add
Adds a component. For detachable components the component becomes the detachable content (it must be aJPanel) and is placed in the detach panel, replacing a placeholder;DETACH_BUTTONcomponents only show a placeholder.- Parameters:
aComp- the component to addaConstraints- layout constraintsaUseScrollbar-trueto wrap detachable content in a scroll pane
-
isClosingRequired
public boolean isClosingRequired()- Returns:
trueif detach windows of this component are still open (and may have to be closed with the form)
-
closeFormComponent
public void closeFormComponent()Called when the form is closed: disposes the open detach windows. -
getTitle
- Returns:
- the Title of Component
-
getSystemID
- Returns:
- the SystemID of Component
-
setTitle
Sets the title and updates the caption label.- Parameters:
aTitle- the title;nullis ignored
-
setDefault
public void setDefault()Sets the value to the attributedefault(tokens replaced), if given. -
toString
-
getRequiredWarning
- Returns:
- the attribute
requiredWarning(tokens replaced), or the localised default warning
-
getCells
public com.lowagie.text.Rectangle[] getCells(int aType) Creates the iText cells for printing or exporting the form: caption cell and value cell, or a value cell spanning two columns if no caption is shown.- Parameters:
aType- output type, e.g.PrintHelper.TYPE_PDF- Returns:
- the cells
-
getValueCell
protected abstract com.lowagie.text.Rectangle getValueCell(int aType) Returns the value cell used for generating the RTF, PDF or HTML version of the form.- Parameters:
aType- output type, e.g.PrintHelper.TYPE_PDF- Returns:
- an iText cell (
PdfPCellfor PDF,Cellotherwise)
-
showBusy
public void showBusy(int aStep) Shows the progress cursor of the given step while the parameters notify their observers.- Specified by:
showBusyin interfacenet.simplace.core.FWBusyIndicator- See Also:
-
hideBusy
public void hideBusy()Restores the default cursor.- Specified by:
hideBusyin interfacenet.simplace.core.FWBusyIndicator- See Also:
-