Remote Systems
v6.4.1

com.ibm.etools.systems.core.ui.widgets
Interface ISystemCombo

All Known Implementing Classes:
SystemConnectionCombo, SystemHistoryCombo, SystemQualifiedRemoteFolderCombo, SystemRemoteFolderCombo

public interface ISystemCombo

We have a number of composite widgets that include a combo-box. This interface enforces some common methods on all of them to make it easier to code to this in a consistent manner.


Field Summary
static String Copyright
           
 
Method Summary
 void addSelectionListener(SelectionListener listener)
          Register a listener interested in an item is selected in the combo box
 void clearSelection()
          Clear the entered/selected contents of the combo box.
 void clearTextSelection()
          Clear the entered/selected contents of the combo box.
 Combo getCombo()
          Return the embedded combo box widget
 int getSelectionIndex()
          Get the index number of the currently selected item.
 String getText()
          Query the combo field's current contents
 void removeSelectionListener(SelectionListener listener)
          Remove a previously set combo box selection listener.
 void select(int selIdx)
          Select the combo dropdown list entry at the given index
 void setAutoUpperCase(boolean enable)
          Set auto-uppercase.
 void setButtonToolTipText(String tip)
          Set the tooltip text for the history button
 void setEnabled(boolean enabled)
          Disable/Enable all the child controls
 boolean setFocus()
          Set the focus to the combo field
 void setSelectionIndex(int selIdx)
          Same as select(int)
 void setToolTipText(String tip)
          Set the tooltip text for the combo field
 void setWidthHint(int widthHint)
          Set the width hint for the combo box widget (in pixels).
 

Field Detail

Copyright

public static final String Copyright
See Also:
Constant Field Values
Method Detail

getCombo

public Combo getCombo()
Return the embedded combo box widget


setAutoUpperCase

public void setAutoUpperCase(boolean enable)
Set auto-uppercase. When enabled, all non-quoted values are uppercased when appropriate


setWidthHint

public void setWidthHint(int widthHint)
Set the width hint for the combo box widget (in pixels). A rule of thumb is 10 pixels per character, but allow 15 for the litte button on the right. You must call this versus setting it yourself, else you may see truncation.


getText

public String getText()
Query the combo field's current contents


setEnabled

public void setEnabled(boolean enabled)
Disable/Enable all the child controls


setToolTipText

public void setToolTipText(String tip)
Set the tooltip text for the combo field


setButtonToolTipText

public void setButtonToolTipText(String tip)
Set the tooltip text for the history button


setFocus

public boolean setFocus()
Set the focus to the combo field


select

public void select(int selIdx)
Select the combo dropdown list entry at the given index


setSelectionIndex

public void setSelectionIndex(int selIdx)
Same as select(int)


clearSelection

public void clearSelection()
Clear the entered/selected contents of the combo box. Clears the text selection and the list selection


clearTextSelection

public void clearTextSelection()
Clear the entered/selected contents of the combo box. Clears only the text selection, not the list selection


getSelectionIndex

public int getSelectionIndex()
Get the index number of the currently selected item.


addSelectionListener

public void addSelectionListener(SelectionListener listener)
Register a listener interested in an item is selected in the combo box

See Also:
removeSelectionListener(SelectionListener)

removeSelectionListener

public void removeSelectionListener(SelectionListener listener)
Remove a previously set combo box selection listener.

See Also:
addSelectionListener(SelectionListener)

Remote Systems
v6.4.1

Copyright © 2005 IBM Corp. All Rights Reserved.

Note: This documentation is for part of an interim API that is still under development and expected to change significantly before reaching stability. It is being made available at this early stage to solicit feedback from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken (repeatedly) as the API evolves.