Class JRibbonComponent
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- org.pushingpixels.flamingo.api.common.RichToolTipManager.JTrackableComponent
-
- org.pushingpixels.flamingo.api.ribbon.JRibbonComponent
-
- All Implemented Interfaces:
ImageObserver,MenuContainer,Serializable
public class JRibbonComponent extends RichToolTipManager.JTrackableComponent
Wrapper around core and 3rd party Swing controls to allow placing them in theJRibbonBand.- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
-
Field Summary
Fields Modifier and Type Field Description static StringuiClassIDThe UI class ID string.-
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
Constructor Summary
Constructors Constructor Description JRibbonComponent(JComponent mainComponent)Creates a simple wrapper with no icon and no caption.JRibbonComponent(ResizableIcon icon, String caption, JComponent mainComponent)Creates a wrapper with an icon and a caption.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description StringgetCaption()Returns the caption of this wrapper component.RibbonElementPrioritygetDisplayPriority()HorizontalAlignmentgetHorizontalAlignment()Returns the horizontal alignment for this wrapper component.ResizableIcongetIcon()Returns the wrapper icon of this wrapper component.StringgetKeyTip()Returns the key tip for this wrapper component.JComponentgetMainComponent()Returns the wrapped component of this wrapper component.RichTooltipgetRichTooltip(MouseEvent mouseEvent)RibbonComponentUIgetUI()Returns the UI object which implements the L&F for this component.StringgetUIClassID()booleanisResizingAware()booleanisSimpleWrapper()Returns indication whether this wrapper is simple.voidsetCaption(String caption)Sets new value for the caption of this wrapper component.voidsetDisplayPriority(RibbonElementPriority displayPriority)voidsetHorizontalAlignment(HorizontalAlignment horizontalAlignment)Sets the specified parameter to be the horizontal alignment for this wrapper component.voidsetKeyTip(String keyTip)Sets the specified string to be the key tip for this wrapper component.voidsetResizingAware(boolean isResizingAware)voidsetRichTooltip(RichTooltip richTooltip)Sets the rich tooltip for this wrapper component.voidupdateUI()-
Methods inherited from class javax.swing.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, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, 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, paramString, 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, update
-
Methods inherited from class java.awt.Container
add, 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, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
-
Methods inherited from class java.awt.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, getAccessibleContext, 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, isEnabled, 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, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
Field Detail
-
uiClassID
public static final String uiClassID
The UI class ID string.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
JRibbonComponent
public JRibbonComponent(JComponent mainComponent)
Creates a simple wrapper with no icon and no caption.- Parameters:
mainComponent- Wrapped component. Can not benull.- Throws:
IllegalArgumentException- ifmainComponentisnull.
-
JRibbonComponent
public JRibbonComponent(ResizableIcon icon, String caption, JComponent mainComponent)
Creates a wrapper with an icon and a caption.- Parameters:
icon- Wrapper icon. Can benull.caption- Wrapper caption. Can not benull.mainComponent- Wrapped component. Can not benull.- Throws:
IllegalArgumentException- ifcaptionormainComponentisnull.
-
-
Method Detail
-
updateUI
public void updateUI()
- Overrides:
updateUIin classJComponent
-
getUIClassID
public String getUIClassID()
- Overrides:
getUIClassIDin classJComponent
-
getUI
public RibbonComponentUI getUI()
Returns the UI object which implements the L&F for this component.- Overrides:
getUIin classJComponent- Returns:
- a
RibbonUIobject - See Also:
JComponent.setUI(javax.swing.plaf.ComponentUI)
-
getIcon
public ResizableIcon getIcon()
Returns the wrapper icon of this wrapper component. Can returnnull.- Returns:
- The wrapper icon of this wrapper component.
- See Also:
JRibbonComponent(ResizableIcon, String, JComponent)
-
getCaption
public String getCaption()
Returns the caption of this wrapper component. Can returnnull.- Returns:
- The caption of this wrapper component.
- See Also:
JRibbonComponent(ResizableIcon, String, JComponent)
-
setCaption
public void setCaption(String caption)
Sets new value for the caption of this wrapper component.- Parameters:
caption- The new caption.
-
getMainComponent
public JComponent getMainComponent()
Returns the wrapped component of this wrapper component. The result is guaranteed to be nonnull.- Returns:
- The wrapped component of this wrapper component.
-
isSimpleWrapper
public boolean isSimpleWrapper()
Returns indication whether this wrapper is simple.- Returns:
trueif bothgetIcon()andgetCaption()returnnull,falseotherwise.
-
getKeyTip
public String getKeyTip()
Returns the key tip for this wrapper component.- Returns:
- The key tip for this wrapper component.
- See Also:
setKeyTip(String)
-
setKeyTip
public void setKeyTip(String keyTip)
Sets the specified string to be the key tip for this wrapper component. Fires akeyTipproperty change event.- Parameters:
keyTip- The new key tip for this wrapper component.
-
getRichTooltip
public RichTooltip getRichTooltip(MouseEvent mouseEvent)
- Specified by:
getRichTooltipin classRichToolTipManager.JTrackableComponent
-
setRichTooltip
public void setRichTooltip(RichTooltip richTooltip)
Sets the rich tooltip for this wrapper component.- Parameters:
richTooltip-- See Also:
getRichTooltip(MouseEvent)
-
getHorizontalAlignment
public HorizontalAlignment getHorizontalAlignment()
Returns the horizontal alignment for this wrapper component.- Returns:
- The horizontal alignment for this wrapper component.
- See Also:
setHorizontalAlignment(HorizontalAlignment)
-
setHorizontalAlignment
public void setHorizontalAlignment(HorizontalAlignment horizontalAlignment)
Sets the specified parameter to be the horizontal alignment for this wrapper component.- Parameters:
horizontalAlignment- The new horizontal alignment for this wrapper component.- See Also:
getHorizontalAlignment()
-
getDisplayPriority
public RibbonElementPriority getDisplayPriority()
-
setDisplayPriority
public void setDisplayPriority(RibbonElementPriority displayPriority)
-
isResizingAware
public boolean isResizingAware()
-
setResizingAware
public void setResizingAware(boolean isResizingAware)
-
-