org.eclipse.swt.widgets.ExpandItem Maven / Gradle / Ivy
/*******************************************************************************
* Copyright (c) 2008, 2013 Innoopract Informationssysteme GmbH and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Innoopract Informationssysteme GmbH - initial API and implementation
* EclipseSource - ongoing development
* Tom Schindl - fix for issue 272674
******************************************************************************/
package org.eclipse.swt.widgets;
import org.eclipse.rap.rwt.internal.textsize.TextSizeUtil;
import org.eclipse.rap.rwt.internal.theme.IThemeAdapter;
import org.eclipse.swt.SWT;
import org.eclipse.swt.SWTException;
import org.eclipse.swt.graphics.Font;
import org.eclipse.swt.graphics.Image;
import org.eclipse.swt.graphics.Rectangle;
import org.eclipse.swt.internal.widgets.expandbarkit.ExpandBarThemeAdapter;
/**
* Instances of this class represent a selectable user interface object that
* represents a expandable item in a expand bar.
*
*
* - Styles:
* - (none)
* - Events:
* - (none)
*
*
*
* IMPORTANT: This class is not intended to be subclassed.
*
*
* @see ExpandBar
* @since 1.2
*/
public class ExpandItem extends Item {
static final int LEFT_MARGIN = 4;
static final int RIGHT_MARGIN = 24;
static final int INTERNAL_SPACING = 4;
static final int CHEVRON_SIZE = 24;
ExpandBar parent;
Control control;
boolean expanded;
int x, y, width, height;
int imageHeight, imageWidth;
/**
* 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 the
* int "|" operator) two or more of those SWT
* style constants. The class description lists the style constants that are
* applicable to the class. Style bits are also inherited from superclasses.
*
*
* @param parent a composite control which will be the parent of the new
* instance (cannot be null)
* @param style the style of control to construct
* @exception IllegalArgumentException
*
* - ERROR_NULL_ARGUMENT - if the parent is null
*
* @exception SWTException
*
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the parent
* - ERROR_INVALID_SUBCLASS - if this class is not an allowed
* subclass
*
* @see Widget#checkSubclass
* @see Widget#getStyle
*/
public ExpandItem( ExpandBar parent, int style ) {
this( parent, style, checkNull( parent ).getItemCount() );
}
/**
* Constructs a new instance of this class given its parent, a style value
* describing its behavior and appearance, and the index at which to place it
* in the items maintained by its parent.
*
* 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. The class description lists the style constants that are
* applicable to the class. Style bits are also inherited from superclasses.
*
*
* @param parent a composite control which will be the parent of the new
* instance (cannot be null)
* @param style the style of control to construct
* @param index the zero-relative index to store the receiver in its parent
* @exception IllegalArgumentException
*
* - ERROR_NULL_ARGUMENT - if the parent is null
* - ERROR_INVALID_RANGE - if the index is not between 0 and
* the number of elements in the parent (inclusive)
*
* @exception SWTException
*
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the parent
* - ERROR_INVALID_SUBCLASS - if this class is not an allowed
* subclass
*
* @see Widget#checkSubclass
* @see Widget#getStyle
*/
public ExpandItem( ExpandBar parent, int style, int index )
{
super( parent, style );
this.parent = parent;
parent.createItem( this, style, index );
}
static ExpandBar checkNull( ExpandBar control ) {
if( control == null ) {
SWT.error( SWT.ERROR_NULL_ARGUMENT );
}
return control;
}
///////////////////
// Widget overrides
@Override
public void dispose() {
if( !isDisposed() ) {
parent.destroyItem( this );
if( control != null ) {
control.dispose();
control = null;
}
super.dispose();
}
}
/**
* Returns the control that is shown when the item is expanded. If no control
* has been set, return null.
*
* @return the control
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public Control getControl() {
checkWidget();
return control;
}
/**
* Returns true if the receiver is expanded, and false
* otherwise.
*
* @return the expanded state
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public boolean getExpanded() {
checkWidget();
return expanded;
}
/**
* Returns the height of the receiver's header
*
* @return the height of the header
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public int getHeaderHeight() {
checkWidget();
int headerHeight = Math.max( parent.getBandHeight(), imageHeight );
headerHeight += getItemHeaderBorderWidth();
return headerHeight;
}
/**
* Gets the height of the receiver.
*
* @return the height
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public int getHeight() {
checkWidget();
return height;
}
/**
* Returns the receiver's parent, which must be a ExpandBar.
*
* @return the receiver's parent
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public ExpandBar getParent() {
checkWidget();
return parent;
}
int getPreferredWidth() {
int result = 0;
if( !isDisposed() ) {
Image image = getImage();
int w = ( image == null )
? 0
: image.getBounds().width;
String text = getText();
if( text != null ) {
if( w > 0 ) {
w += INTERNAL_SPACING;
}
Font parentFont = getParent().getFont();
w += TextSizeUtil.stringExtent( parentFont, text ).x;
}
result = w + LEFT_MARGIN + RIGHT_MARGIN;
}
return result;
}
Rectangle getBounds() {
Rectangle result;
if( expanded ) {
result = new Rectangle( x, y, width, getHeaderHeight() + height );
} else {
result = new Rectangle( x, y, width, getHeaderHeight() );
}
return result;
}
void setBounds( int x, int y, int width, int height, boolean move, boolean size ) {
int headerHeight = getHeaderHeight();
int aX = x;
int aY = y;
int aWidth = width;
int aHeight = height;
if( move ) {
if( imageHeight > headerHeight ) {
aY += ( imageHeight - headerHeight );
}
this.x = aX;
this.y = aY;
}
if( size ) {
this.width = aWidth;
this.height = aHeight;
}
if( control != null && !control.isDisposed() ) {
if( !parent.isAppThemed() ) {
int border = getItemBorderWidth();
aX += border;
aWidth = Math.max( 0, aWidth - border * 2 );
aHeight = Math.max( 0, aHeight - border );
}
if( move && size ) {
control.setBounds( aX, aY + headerHeight, aWidth, aHeight );
}
if( move && !size ) {
control.setLocation( aX, aY + headerHeight );
}
if( !move && size ) {
control.setSize( aWidth, aHeight );
}
}
}
/**
* Sets the control that is shown when the item is expanded.
*
* @param control the new control (or null)
* @exception IllegalArgumentException
*
* - ERROR_INVALID_ARGUMENT - if the control has been disposed
* - ERROR_INVALID_PARENT - if the control is not in the same
* widget tree
*
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public void setControl( Control control ) {
checkWidget();
if( control != null ) {
if( control.isDisposed() ) {
error( SWT.ERROR_INVALID_ARGUMENT );
}
if( control.parent != parent ) {
error( SWT.ERROR_INVALID_PARENT );
}
}
this.control = control;
if( control != null ) {
int headerHeight = getHeaderHeight();
control.setVisible( expanded );
if( !parent.isAppThemed() ) {
int border = getItemBorderWidth();
int width = Math.max( 0, this.width - border * 2 );
int height = Math.max( 0, this.height - border );
control.setBounds( x + border, y + headerHeight, width, height );
} else {
control.setBounds( x, y + headerHeight, width, height );
}
}
}
/**
* Sets the expanded state of the receiver.
*
* @param expanded the new expanded state
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public void setExpanded( boolean expanded ) {
checkWidget();
this.expanded = expanded;
parent.showItem( this );
}
/**
* Sets the height of the receiver. This is height of the item when it is
* expanded, excluding the height of the header.
*
* @param height the new height
* @exception SWTException
*
* - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
* - ERROR_THREAD_INVALID_ACCESS - if not called from the
* thread that created the receiver
*
*/
public void setHeight( int height ) {
checkWidget();
if( height >= 0 ) {
setBounds( 0, 0, width, height, false, true );
if( expanded ) {
parent.layoutItems( parent.indexOf( this ) + 1, true );
}
}
}
@Override
public void setImage( Image image ) {
checkWidget();
if( image != getImage() ) {
super.setImage( image );
updateBounds();
}
int oldImageHeight = imageHeight;
if( image != null ) {
Rectangle bounds = image.getBounds();
imageHeight = bounds.height;
imageWidth = bounds.width;
} else {
imageHeight = imageWidth = 0;
}
if( oldImageHeight != imageHeight ) {
parent.layoutItems( parent.indexOf( this ), true );
}
}
@Override
public void setText( String string ) {
checkWidget();
if( string == null ) {
SWT.error( SWT.ERROR_NULL_ARGUMENT );
}
if( !string.equals( getText() ) ) {
super.setText( string );
updateBounds();
}
}
private void updateBounds() {
int parentWidth = parent.computeSize( SWT.DEFAULT, SWT.DEFAULT, false ).x;
int scrollBarWidth = parent.getVScrollBarWidth();
int availableWidth = parentWidth - 2 * parent.spacing - scrollBarWidth;
width = Math.max( getPreferredWidth(), availableWidth );
setBounds( 0, 0, width, height, false, true );
}
////////////////////////////
// Helping methods - various
int getItemBorderWidth() {
ExpandBarThemeAdapter themeAdapter
= ( ExpandBarThemeAdapter )parent.getAdapter( IThemeAdapter.class );
return themeAdapter.getItemBorderWidth( parent );
}
int getItemHeaderBorderWidth() {
ExpandBarThemeAdapter themeAdapter
= ( ExpandBarThemeAdapter )parent.getAdapter( IThemeAdapter.class );
return themeAdapter.getItemHeaderBorderWidth( parent );
}
}