iSeries Remote Systems
v6.0.0

com.ibm.etools.iseries.core.ui.widgets
Class ISeriesInteractiveConnectionCombo

java.lang.Object
  extended byorg.eclipse.swt.widgets.Widget
      extended byorg.eclipse.swt.widgets.Control
          extended byorg.eclipse.swt.widgets.Scrollable
              extended byorg.eclipse.swt.widgets.Composite
                  extended bycom.ibm.etools.systems.core.ui.widgets.SystemConnectionCombo
                      extended bycom.ibm.etools.iseries.core.ui.widgets.ISeriesConnectionCombo
                          extended bycom.ibm.etools.iseries.core.ui.widgets.ISeriesInteractiveConnectionCombo
All Implemented Interfaces:
DisposeListener, Drawable, EventListener, ISelectionProvider, com.ibm.etools.systems.core.ui.widgets.ISystemCombo, com.ibm.etools.systems.model.ISystemResourceChangeEvents, com.ibm.etools.systems.model.ISystemResourceChangeListener, SWTEventListener

public class ISeriesInteractiveConnectionCombo
extends ISeriesConnectionCombo

This re-usable widget is for selecting an iSeries connection from the master list of connections. The list is subsettable by one or more system types. There is also the option of including a "New" button to the right of the connection dropdown, for the purpose of creating a new connection.

Without the New button, the composite is layed as follows:


   Connection: ______________________v  
 

With the New button, the composite is layed as follows:


   Connection: ______________v  New...
 


Field Summary
static String copyright
           
protected  Button refreshButton
           
 
Fields inherited from class com.ibm.etools.systems.core.ui.widgets.SystemConnectionCombo
connectionCombo, connectionLabel, listeningForConnectionEvents, newButton, showLabel, showNewButton, showQualifiedNames
 
Fields inherited from class org.eclipse.swt.widgets.Control
handle
 
Fields inherited from interface com.ibm.etools.systems.core.ui.widgets.ISystemCombo
Copyright
 
Fields inherited from interface com.ibm.etools.systems.model.ISystemResourceChangeEvents
EVENT_ADD, EVENT_ADD_FILTER_REFERENCE, EVENT_ADD_FILTERSTRING_REFERENCE, EVENT_ADD_MANY, EVENT_ADD_RELATIVE, EVENT_CHANGE_CHILDREN, EVENT_CHANGE_FILTER_REFERENCE, EVENT_CHANGE_FILTERSTRING_REFERENCE, EVENT_COLLAPSE_ALL, EVENT_COLLAPSE_SELECTED, EVENT_COMMAND_FINISHED, EVENT_COMMAND_HISTORY_UPDATE, EVENT_COMMAND_MESSAGE, EVENT_COMMAND_RUN, EVENT_COMMAND_SHELL_FINISHED, EVENT_COMMAND_SHELL_REMOVED, EVENT_COMPILE_COMMAND_RUN, EVENT_DELETE, EVENT_DELETE_FILTER_REFERENCE, EVENT_DELETE_FILTERSTRING_REFERENCE, EVENT_DELETE_MANY, EVENT_EXPAND_SELECTED, EVENT_ICON_CHANGE, EVENT_MOVE_FILTER_REFERENCES, EVENT_MOVE_FILTERSTRING_REFERENCES, EVENT_MOVE_MANY, EVENT_MUST_COLLAPSE, EVENT_PROPERTY_CHANGE, EVENT_PROPERTYSHEET_UPDATE, EVENT_REFRESH, EVENT_REFRESH_REMOTE, EVENT_REFRESH_SELECTED, EVENT_REFRESH_SELECTED_FILTER, EVENT_REFRESH_SELECTED_PARENT, EVENT_RENAME, EVENT_RENAME_FILTER_REFERENCE, EVENT_REPLACE_CHILDREN, EVENT_REVEAL_AND_SELECT, EVENT_SEARCH_FINISHED, EVENT_SELECT, EVENT_SELECT_EXPAND, EVENT_SELECT_REMOTE, PROPERTYSHEET_UPDATE_EVENT
 
Constructor Summary
ISeriesInteractiveConnectionCombo(Composite parent, int style, ISeriesConnection defaultConnection, boolean showNewButton)
          Constructor when you want to set the style
ISeriesInteractiveConnectionCombo(Composite parent, int style, com.ibm.etools.systems.model.SystemConnection defaultConnection, boolean showNewButton)
          Constructor when you want to set the style
ISeriesInteractiveConnectionCombo(Composite parent, ISeriesConnection defaultConnection, boolean showNewButton)
          Constructor when you don't care about the style.
ISeriesInteractiveConnectionCombo(Composite parent, com.ibm.etools.systems.model.SystemConnection defaultConnection, boolean showNewButton)
          Constructor when you don't care about the style.
 
Method Summary
protected  boolean populateConnectionCombo(Combo combo, String systemType, com.ibm.etools.systems.model.SystemConnection defaultConnection, boolean preSelectIfNoMatch)
          Populates a readonly connection combobox instance with system connections for the given system type.
 
Methods inherited from class com.ibm.etools.iseries.core.ui.widgets.ISeriesConnectionCombo
addSelectionListener, getISeriesConnection, getNewConnectionAction, lineUpWith, lineUpWith, select
 
Methods inherited from class com.ibm.etools.systems.core.ui.widgets.SystemConnectionCombo
addModifyListener, addNewButtonSelectionListener, addOurButtonSelectionListener, addOurConnectionSelectionListener, addSelectionChangedListener, addSelectionListener, clearSelection, clearTextSelection, createCombo, createConnectionCombo, createPushButton, createPushButton, getCombo, getConnections, getGridColumns, getItems, getNewButton, getPromptLabel, getSelection, getSelectionIndex, getSystemConnection, getText, init, init, listenToConnectionEvents, populateConnectionCombo, populateConnectionCombo, populateConnectionCombo, populateConnectionCombo, populateConnectionCombo, prepareComposite, refreshConnections, removeModifyListener, removeNewButtonSelectionListener, removeSelectionChangedListener, removeSelectionListener, select, select, setAutoUpperCase, setBusyCursor, setButtonToolTipText, setButtonWidthHint, setButtonWidthHint, setConnections, setConnectionToolTipText, setEnabled, setFocus, setItems, setLabel, setNewButtonFocus, setNewButtonToolTipText, setSelection, setSelectionIndex, setToolTipText, setWidthHint, sub, systemResourceChanged, widgetDisposed
 
Methods inherited from class org.eclipse.swt.widgets.Composite
checkSubclass, computeSize, getChildren, getLayout, getTabList, layout, layout, setLayout, setTabList
 
Methods inherited from class org.eclipse.swt.widgets.Scrollable
computeTrim, getClientArea, getHorizontalBar, getVerticalBar
 
Methods inherited from class org.eclipse.swt.widgets.Control
addControlListener, addFocusListener, addHelpListener, addKeyListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addPaintListener, addTraverseListener, computeSize, forceFocus, getAccessible, getBackground, getBorderWidth, getBounds, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getParent, getShell, getSize, getToolTipText, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isFocusControl, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, redraw, redraw, removeControlListener, removeFocusListener, removeHelpListener, removeKeyListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removePaintListener, removeTraverseListener, setBackground, setBounds, setBounds, setCapture, setCursor, setFont, setForeground, setLayoutData, setLocation, setLocation, setMenu, setParent, setRedraw, setSize, setSize, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, update
 
Methods inherited from class org.eclipse.swt.widgets.Widget
addDisposeListener, addListener, checkWidget, dispose, getData, getData, getDisplay, getStyle, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, setData, setData, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.ibm.etools.systems.model.ISystemResourceChangeListener
getShell
 

Field Detail

copyright

public static final String copyright
See Also:
Constant Field Values

refreshButton

protected Button refreshButton
Constructor Detail

ISeriesInteractiveConnectionCombo

public ISeriesInteractiveConnectionCombo(Composite parent,
                                         int style,
                                         com.ibm.etools.systems.model.SystemConnection defaultConnection,
                                         boolean showNewButton)
Constructor when you want to set the style

Parameters:
parent - Parent composite
style - SWT style flags for overall composite widget. Typically just pass SWT.NULL
defaultConnection - the system connection to preselect. Pass null to preselect first connection.
showNewButton - true if a New... button is to be included in this composite

ISeriesInteractiveConnectionCombo

public ISeriesInteractiveConnectionCombo(Composite parent,
                                         com.ibm.etools.systems.model.SystemConnection defaultConnection,
                                         boolean showNewButton)
Constructor when you don't care about the style. Defaults to SWT.NULL

Parameters:
parent - Parent composite
defaultConnection - the system connection to preselect. Pass null to preselect first connection.
showNewButton - true if a New... button is to be included in this composite

ISeriesInteractiveConnectionCombo

public ISeriesInteractiveConnectionCombo(Composite parent,
                                         int style,
                                         ISeriesConnection defaultConnection,
                                         boolean showNewButton)
Constructor when you want to set the style

Parameters:
parent - Parent composite
style - SWT style flags for overall composite widget. Typically just pass SWT.NULL
defaultConnection - the AS/400 connection to preselect. Pass null to preselect first connection.
showNewButton - true if a New... button is to be included in this composite

ISeriesInteractiveConnectionCombo

public ISeriesInteractiveConnectionCombo(Composite parent,
                                         ISeriesConnection defaultConnection,
                                         boolean showNewButton)
Constructor when you don't care about the style. Defaults to SWT.NULL

Parameters:
parent - Parent composite
defaultConnection - the AS/400 connection to preselect. Pass null to preselect first connection.
showNewButton - true if a New... button is to be included in this composite
Method Detail

populateConnectionCombo

protected boolean populateConnectionCombo(Combo combo,
                                          String systemType,
                                          com.ibm.etools.systems.model.SystemConnection defaultConnection,
                                          boolean preSelectIfNoMatch)
Populates a readonly connection combobox instance with system connections for the given system type.

This fills the combination with the names of all the active connections of the given system type.

Parameters:
systemType - the system type to restrict the connection list to. Pass null or * for all system types
defaultConnection - the default system connection to preselect.
preSelectIfNoMatch - true if we should preselect the first item if the given connection is not found
Returns:
true if given default connection was found and selected

iSeries Remote Systems
v6.0.0

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.