com.ibm.commons.swt.data.controls
Class DCCompositeCombo

java.lang.Object
  extended by org.eclipse.swt.widgets.Widget
      extended by org.eclipse.swt.widgets.Control
          extended by org.eclipse.swt.widgets.Scrollable
              extended by org.eclipse.swt.widgets.Composite
                  extended by com.ibm.commons.swt.controls.custom.CustomComposite
                      extended by com.ibm.commons.swt.data.editors.api.CompositeEditor
                          extended by com.ibm.commons.swt.data.controls.DCCompositeEditor
                              extended by com.ibm.commons.swt.data.controls.DCCompositeCombo
All Implemented Interfaces:
CompositeWithDynamicChildren, ICustomControl, IDataControl, IDataFieldControl, org.eclipse.swt.graphics.Drawable

public class DCCompositeCombo
extends DCCompositeEditor

Combobox control binded to data.


Field Summary
 
Fields inherited from class com.ibm.commons.swt.data.editors.api.CompositeEditor
cmptdDialogButton, COMPUTED_IMG, COMPUTED_IMG_HC, COMPUTED_IMG_HOVER, COMPUTED_IMG_HOVER_HC, control, CUSTOM_EDITOR_IMG, CUSTOM_EDITOR_IMG_HC, delButton, dialogButton, extraLabel, IMG_BROWSEBUTTON, IMG_BROWSEBUTTON_HC, IMG_COMPUTED, IMG_VALUEBINDING, label, menuButton, NON_COMPUTED_IMG, NON_COMPUTED_IMG_HC, NON_COMPUTED_IMG_HOVER, NON_COMPUTED_IMG_HOVER_HC, realControl, realDialogButton
 
Fields inherited from class org.eclipse.swt.widgets.Control
handle
 
Constructor Summary
DCCompositeCombo(org.eclipse.swt.widgets.Composite parent, int style, boolean isEditable, java.lang.String id)
          Constructs a new instance of the class given the parent Composite, the style flags which are used to set the look/behavior of the control, a flag to determine if the values in the combo can be edited, and an id property that can be used to programatically identify the control.
DCCompositeCombo(org.eclipse.swt.widgets.Composite parent, int style, java.lang.String id)
          Constructs a new instance of the class given the parent Composite, the style flags which are used to set the look/behavior of the control, and an id property that can be used to programatically identify the control.
 
Method Summary
 int getCols()
          Returns the number of columns wide the combo box is.
 java.lang.String getComboText()
          Returns the current value of the combo box
 java.lang.String getDefaultValue()
          Returns the default value of the control
 java.lang.String getDialogButtonText()
          Returns the text that is to appear on the dialog button.
 java.lang.String getFirstLineTitle()
          Used in conjunction with isFirstBlankLine().
 com.ibm.commons.swt.data.controls.IListActions getListActions()
          Returms a list of actions that can be performed by the combo box.
 ILookup getLookup()
          Returns the lookup that is used to populate the contents of the control.
 boolean isDialogButton()
          Returns whether or not this composite control has a dialog button associated with it.
 boolean isFirstBlankLine()
          Returns whether or not the first item in the combo box should be null? The default value is false.
 void setCols(int cols)
          Sets the number of columns wide the combo box should be.
 void setDefaultValue(java.lang.String text)
          Sets the default value of the control
 void setDialogButton(boolean dialogButton)
          Sets whether or not this composite control has a dialog button associated with it.
 void setDialogButtonText(java.lang.String dialogButtonText)
          Sets the text that is to appear on the dialog button.
 void setFirstBlankLine(boolean firstBlankLine)
          Sets whether or not the first line in the combo box will be blank.
 void setFirstLineTitle(java.lang.String firstLineTitle)
          Used in conjunction with isFirstBlankLine().
 void setListActions(com.ibm.commons.swt.data.controls.IListActions listActions)
          Sets the list of actions that can be performed by the combo box.
 void setLookup(ILookup lookup)
          Sets the lookup used to populate the contents of the control.
 void updateControls()
          Updates the control value based on the value of the associated attribute in the model
 
Methods inherited from class com.ibm.commons.swt.data.controls.DCCompositeEditor
getAttributeName, getControl, getDataNode, getEditorOptions, getPropertyEditor, getPropertyEditorName, getPropertyEditorParameter, initEditor, setAttributeName, setDataNode, setDataNodeBinding, setPropertyEditor, setPropertyEditorName, setPropertyEditorParameter
 
Methods inherited from class com.ibm.commons.swt.data.editors.api.CompositeEditor
addCompositeChildrenListener, addListeners, addValueChangedListener, callDialog, callScriptDialog, checkBtnVisible, getComputedLabelString, getComputedLabelTooltip, getCurrentValueType, getEditor, getEditorControl, getLabel, getMenuButtonImage, getMenuButtonImageHover, getPropertyEditorScriptMode, getRealControl, getValue, handleDeleteButton, hasCmptdAccessBtn, hasMenuButton, initComputedLabel, initPropertyEditor, isCellEditor, isComputable, isPrimitiveCollectionItemNode, isPropertyEditorScriptModeFixed, postDisposeEditor, removeCompositeChildrenListener, removeValueChangedListener, setAccessibleListener, setEnabled, setHasCmptdAccessBtn, setHasMenuButton, setIsComputable, setLabel, setTraverseListener, setValue, showPopUpMenu, updateValue
 
Methods inherited from class com.ibm.commons.swt.controls.custom.CustomComposite
getId, getUpdater, setId, setUpdater
 
Methods inherited from class org.eclipse.swt.widgets.Composite
changed, checkSubclass, computeSize, drawBackground, getBackgroundMode, getChildren, getLayout, getLayoutDeferred, getTabList, isLayoutDeferred, layout, layout, layout, layout, layout, setBackgroundMode, setFocus, setLayout, setLayoutDeferred, setTabList
 
Methods inherited from class org.eclipse.swt.widgets.Scrollable
computeTrim, getBorderWidth, getClientArea, getHorizontalBar, getVerticalBar
 
Methods inherited from class org.eclipse.swt.widgets.Control
addControlListener, addDragDetectListener, addFocusListener, addHelpListener, addKeyListener, addMenuDetectListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addMouseWheelListener, addPaintListener, addTraverseListener, computeSize, dragDetect, dragDetect, forceFocus, getAccessible, getBackground, getBackgroundImage, getBounds, getCursor, getDragDetect, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getParent, getRegion, getShell, getSize, getToolTipText, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isFocusControl, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, print, redraw, redraw, removeControlListener, removeDragDetectListener, removeFocusListener, removeHelpListener, removeKeyListener, removeMenuDetectListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removeMouseWheelListener, removePaintListener, removeTraverseListener, setBackground, setBackgroundImage, setBounds, setBounds, setCapture, setCursor, setDragDetect, setFont, setForeground, setLayoutData, setLocation, setLocation, setMenu, setParent, setRedraw, setRegion, setSize, setSize, setToolTipText, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, traverse, traverse, update
 
Methods inherited from class org.eclipse.swt.widgets.Widget
addDisposeListener, addListener, checkWidget, dispose, getData, getData, getDisplay, getListeners, getStyle, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, reskin, setData, setData, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DCCompositeCombo

public DCCompositeCombo(org.eclipse.swt.widgets.Composite parent,
                        int style,
                        java.lang.String id)
Constructs a new instance of the class given the parent Composite, the style flags which are used to set the look/behavior of the control, and an id property that can be used to programatically identify the control.

The style value is either one of the style constants defined in class SWT which is applicable to instances of this class, or must be built by bitwise OR'ing together (that is, using the int "|" operator) two or more of those SWT style constants. Style bits are also inherited from superclasses.

Parameters:
parent - a Composite control which will be the parent of the new instance (CANNOT be null).
style - the style of control to construct
id - a String which can be used to programatically identify the control

DCCompositeCombo

public DCCompositeCombo(org.eclipse.swt.widgets.Composite parent,
                        int style,
                        boolean isEditable,
                        java.lang.String id)
Constructs a new instance of the class given the parent Composite, the style flags which are used to set the look/behavior of the control, a flag to determine if the values in the combo can be edited, and an id property that can be used to programatically identify the control.

The style value is either one of the style constants defined in class SWT which is applicable to instances of this class, or must be built by bitwise OR'ing together (that is, using the int "|" operator) two or more of those SWT style constants. Style bits are also inherited from superclasses.

Parameters:
parent - a Composite control which will be the parent of the new instance (CANNOT be null).
style - the style of control to construct
isEditable - sets whether or not the values in the combo can be edited
id - a String which can be used to programatically identify the control
Method Detail

getCols

public int getCols()
Returns the number of columns wide the combo box is.

Returns:
int

setCols

public void setCols(int cols)
Sets the number of columns wide the combo box should be. Each column is calculated to be the average width of a single character.

Parameters:
cols -

isFirstBlankLine

public boolean isFirstBlankLine()
Returns whether or not the first item in the combo box should be null? The default value is false. If true the first item in the combo will be null regardless of the values supplied via the lookup.

Returns:
boolean

setFirstBlankLine

public void setFirstBlankLine(boolean firstBlankLine)
Sets whether or not the first line in the combo box will be blank. If true the first line will be blank regardless of the values supplied via the lookup.

Parameters:
firstBlankLine -

getFirstLineTitle

public java.lang.String getFirstLineTitle()
Used in conjunction with isFirstBlankLine(). If the first line of the control is set to be blank then the title supplied by getFirstLineTitle() will be used as the text for the first line.

Returns:
String

setFirstLineTitle

public void setFirstLineTitle(java.lang.String firstLineTitle)
Used in conjunction with isFirstBlankLine(). If the first line of the control is set to be blank then the title set by setFirstLineTitle() will be used as the text for the first line.

Parameters:
String -

getListActions

public com.ibm.commons.swt.data.controls.IListActions getListActions()
Returms a list of actions that can be performed by the combo box.

Returns:

setListActions

public void setListActions(com.ibm.commons.swt.data.controls.IListActions listActions)
Sets the list of actions that can be performed by the combo box.

Parameters:
listActions -

getLookup

public ILookup getLookup()
Returns the lookup that is used to populate the contents of the control.

Returns:
ILookup
See Also:
ILookup

setLookup

public void setLookup(ILookup lookup)
Sets the lookup used to populate the contents of the control. A lookup is basically a simple model whereby the value of the data set by the control differs with what appears in the UI, analogous to a key-value pair.

Parameters:
lookup - - ILookup

isDialogButton

public boolean isDialogButton()
Returns whether or not this composite control has a dialog button associated with it. If true extra room will be laid out for a button control which will perform a user defined action when pressed.

Returns:

setDialogButton

public void setDialogButton(boolean dialogButton)
Sets whether or not this composite control has a dialog button associated with it. If true extra room will be laid out for a button control which will perform a user defined action when pressed.

Parameters:
boolean -

getDialogButtonText

public java.lang.String getDialogButtonText()
Returns the text that is to appear on the dialog button.

Returns:
String

setDialogButtonText

public void setDialogButtonText(java.lang.String dialogButtonText)
Sets the text that is to appear on the dialog button.

Parameters:
dialogButtonText -

getComboText

public java.lang.String getComboText()
Returns the current value of the combo box

Returns:
String

setDefaultValue

public void setDefaultValue(java.lang.String text)
Sets the default value of the control

Parameters:
value - String

getDefaultValue

public java.lang.String getDefaultValue()
Returns the default value of the control

Returns:
String

updateControls

public void updateControls()
Updates the control value based on the value of the associated attribute in the model

Overrides:
updateControls in class CompositeEditor