Package org.eclipse.swt.custom
Class CBanner
java.lang.Object
org.eclipse.swt.widgets.Widget
org.eclipse.swt.widgets.Control
org.eclipse.swt.widgets.Scrollable
org.eclipse.swt.widgets.Composite
org.eclipse.swt.custom.CBanner
- All Implemented Interfaces:
Drawable
Instances of this class implement a Composite that lays out its
children and allows programmatic control of the layout. It draws
a separator between the left and right children which can be dragged
to resize the right control.
CBanner is used in the workbench to layout the toolbar area and
perspective switching toolbar.
Note that although this class is a subclass of Composite
,
it does not make sense to set a layout on it.
- Styles:
- NONE
- Events:
- (None)
IMPORTANT: This class is not intended to be subclassed.
- Since:
- 3.0
- See Also:
- Restriction:
- This class is not intended to be subclassed by clients.
-
Field Summary
Fields inherited from class org.eclipse.swt.widgets.Widget
nativeZoom
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionReturns the Control that appears on the bottom side of the banner.Returns a rectangle which describes the area of the receiver which is capable of displaying data (that is, not covered by the "trimmings").getLeft()
Returns the Control that appears on the left side of the banner.getRight()
Returns the Control that appears on the right side of the banner.Returns the minimum size of the control that appears on the right of the banner.int
Returns the width of the control that appears on the right of the banner.boolean
Returnstrue
if the CBanner is rendered with a simple, traditional shape.void
Set the control that appears on the bottom side of the banner.void
Sets the layout which is associated with the receiver to be the argument which may be null.void
Set the control that appears on the left side of the banner.void
Set the control that appears on the right side of the banner.void
setRightMinimumSize
(Point size) Set the minimum height of the control that appears on the right side of the banner.void
setRightWidth
(int width) Set the width of the control that appears on the right side of the banner.void
setSimple
(boolean simple) Sets the shape that the CBanner will use to render itself.Methods inherited from class org.eclipse.swt.widgets.Composite
changed, checkSubclass, drawBackground, getBackgroundMode, getChildren, getLayout, getLayoutDeferred, getTabList, isLayoutDeferred, layout, layout, layout, layout, layout, setBackgroundMode, setFocus, setLayoutDeferred, setTabList, toString
Methods inherited from class org.eclipse.swt.widgets.Scrollable
computeTrim, getHorizontalBar, getScrollbarsMode, getVerticalBar, setScrollbarsMode
Methods inherited from class org.eclipse.swt.widgets.Control
addControlListener, addDragDetectListener, addFocusListener, addGestureListener, addHelpListener, addKeyListener, addMenuDetectListener, addMouseListener, addMouseMoveListener, addMouseTrackListener, addMouseWheelListener, addPaintListener, addTouchListener, addTraverseListener, computeSize, computeSize, dragDetect, dragDetect, forceFocus, getAccessible, getBackground, getBackgroundImage, getBorderWidth, getBounds, getCursor, getDragDetect, getEnabled, getFont, getForeground, getLayoutData, getLocation, getMenu, getMonitor, getOrientation, getParent, getRegion, getShell, getSize, getTextDirection, getToolTipText, getTouchEnabled, getVisible, internal_dispose_GC, internal_new_GC, isEnabled, isFocusControl, isReparentable, isVisible, moveAbove, moveBelow, pack, pack, print, redraw, redraw, removeControlListener, removeDragDetectListener, removeFocusListener, removeGestureListener, removeHelpListener, removeKeyListener, removeMenuDetectListener, removeMouseListener, removeMouseMoveListener, removeMouseTrackListener, removeMouseWheelListener, removePaintListener, removeTouchListener, removeTraverseListener, requestLayout, setBackground, setBackgroundImage, setBounds, setBounds, setCapture, setCursor, setDragDetect, setEnabled, setFont, setForeground, setLayoutData, setLocation, setLocation, setMenu, setOrientation, setParent, setRedraw, setRegion, setSize, setSize, setTextDirection, setToolTipText, setTouchEnabled, setVisible, toControl, toControl, toDisplay, toDisplay, traverse, traverse, traverse, update
Methods inherited from class org.eclipse.swt.widgets.Widget
addDisposeListener, addListener, addTypedListener, checkWidget, dispose, getData, getData, getDisplay, getListeners, getStyle, getTypedListeners, isAutoDirection, isDisposed, isListening, notifyListeners, removeDisposeListener, removeListener, removeListener, removeTypedListener, reskin, setData, setData
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.eclipse.swt.graphics.Drawable
isAutoScalable
-
Constructor Details
-
CBanner
Constructs a new instance of this class given its parent and a style value describing its behavior and appearance.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 theint
"|" operator) two or more of thoseSWT
style constants. The class description lists the style constants that are applicable to the class. Style bits are also inherited from superclasses.- Parameters:
parent
- a widget which will be the parent of the new instance (cannot be null)style
- the style of widget to construct- Throws:
IllegalArgumentException
-- ERROR_NULL_ARGUMENT - if the parent is null
SWTException
-- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent
-
-
Method Details
-
getBottom
Returns the Control that appears on the bottom side of the banner.- Returns:
- the control that appears on the bottom side of the banner or null
- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- Since:
- 3.0
-
getClientArea
Description copied from class:Scrollable
Returns a rectangle which describes the area of the receiver which is capable of displaying data (that is, not covered by the "trimmings").- Overrides:
getClientArea
in classScrollable
- Returns:
- the client area
- See Also:
-
getLeft
Returns the Control that appears on the left side of the banner.- Returns:
- the control that appears on the left side of the banner or null
- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- Since:
- 3.0
-
getRight
Returns the Control that appears on the right side of the banner.- Returns:
- the control that appears on the right side of the banner or null
- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- Since:
- 3.0
-
getRightMinimumSize
Returns the minimum size of the control that appears on the right of the banner.- Returns:
- the minimum size of the control that appears on the right of the banner
- Since:
- 3.1
-
getRightWidth
public int getRightWidth()Returns the width of the control that appears on the right of the banner.- Returns:
- the width of the control that appears on the right of the banner
- Since:
- 3.0
-
getSimple
public boolean getSimple()Returnstrue
if the CBanner is rendered with a simple, traditional shape.- Returns:
true
if the CBanner is rendered with a simple shape- Since:
- 3.0
-
setBottom
Set the control that appears on the bottom side of the banner. The bottom control is optional. Setting the bottom control to null will remove it from the banner - however, the creator of the control must dispose of the control.- Parameters:
control
- the control to be displayed on the bottom or null- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- ERROR_INVALID_ARGUMENT - if the bottom control was not created as a child of the receiver
- Since:
- 3.0
-
setLayout
Sets the layout which is associated with the receiver to be the argument which may be null.Note: No Layout can be set on this Control because it already manages the size and position of its children.
- Overrides:
setLayout
in classComposite
- Parameters:
layout
- the receiver's new layout or null- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
-
setLeft
Set the control that appears on the left side of the banner. The left control is optional. Setting the left control to null will remove it from the banner - however, the creator of the control must dispose of the control.- Parameters:
control
- the control to be displayed on the left or null- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- ERROR_INVALID_ARGUMENT - if the left control was not created as a child of the receiver
- Since:
- 3.0
-
setRight
Set the control that appears on the right side of the banner. The right control is optional. Setting the right control to null will remove it from the banner - however, the creator of the control must dispose of the control.- Parameters:
control
- the control to be displayed on the right or null- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- ERROR_INVALID_ARGUMENT - if the right control was not created as a child of the receiver
- Since:
- 3.0
-
setRightMinimumSize
Set the minimum height of the control that appears on the right side of the banner.- Parameters:
size
- the minimum size of the control on the right- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- ERROR_INVALID_ARGUMENT - if the size is null or the values of size are less than SWT.DEFAULT
- Since:
- 3.1
-
setRightWidth
public void setRightWidth(int width) Set the width of the control that appears on the right side of the banner.- Parameters:
width
- the width of the control on the right- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- ERROR_INVALID_ARGUMENT - if width is less than SWT.DEFAULT
- Since:
- 3.0
-
setSimple
public void setSimple(boolean simple) Sets the shape that the CBanner will use to render itself.- Parameters:
simple
-true
if the CBanner should render itself in a simple, traditional style- Throws:
SWTException
-- ERROR_WIDGET_DISPOSED - if the receiver has been disposed
- ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver
- Since:
- 3.0
-