Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

An Eclipse Nebula widgets primer

A quick guide to Eclipse Nebula's Grid, CDateTime, CompositeTable, PGroup and PShelf widgets

Scott Delap (scott@clientjava.com), President, Rich Client Solutions Inc.
Scott Delap is president of Rich Client Solutions Inc., a software consulting firm focusing on technologies such as Swing, Eclipse RCP, GWT, Flex, and Open Laszlo. He is actively involved in the Java community, speaking at events such as NFJS, QCon and JavaOne. He is also the Java editor of InfoQ.com and runs ClientJava.com, a portal focused on desktop Java development.
Barry Livingston (iblivin@gmail.com), Senior Software Engineer, MichaelDKelly.com
Barry Livingston has been developing software for more than eight years. A specialist in rich client development, he is focused on client technologies such as Swing and Eclipse RCP. Active in the Java community, he has often partnered with Rich Client Solutions to provide high-quality rich client development and consulting services to a variety of clients.

Summary:  The SWT toolkit offers a robust interface to the native widgets of the operating system it's running on. However, native widgets often aren't enough. The Eclipse Nebula project is working to bridge this gap with custom widgets for functionality, including calendaring and advanced tables. This tutorial demonstrates five Nebula widgets, including Grid, CDateTime, CompositeTable, PGroup, and PShelf.

Date:  17 Apr 2007
Level:  Intermediate PDF:  A4 and Letter (1206 KB | 47 pages)Get Adobe® Reader®

Activity:  20724 views
Comments:  

The basics of CompositeTable

The easiest way to learn the CompositeTable application program interface (API) is to review the snippets included in the download. Open CompositeTableSnippet1 and scroll down to the main method. You can see that the widget is created, and Header and Row objects are created. These objects determine how the CompositeTable displays headers and rows. If you look at the Header implementation, you see that it contains two Label widgets positioned using a GridLayout. Run the example, and the window is similar to that shown below.


Figure 9. CompositeTableSnippet1
CompositeTableSnippet1

Next, change the Header class, as shown below.


Listing 3. Header changes
                    
public Header(Composite parent, int style) {
	super(parent, style);
    setLayout(new GridRowLayout(new int[] { 160, 100 }, false));
	Label first = new Label(this, SWT.NULL);
	first.setText("First Name");
	first.setForeground(Display.getCurrent().getSystemColor(SWT.COLOR_RED));
	first.setBackground(Display.getCurrent().getSystemColor(SWT.COLOR_BLACK));
	new Label(this, SWT.NULL).setText("Last Name");
}

Running the example now shows the Header changes, as displayed in Figure 10.


Figure 10. Change the header
Change the header

The other key component to the display of a CompositeTable is the Row object. Reviewing the Row class definition in CompositeTableSnippet1 reveals two Text widgets positioned using GridLayout. The final piece of the puzzle is the content provider added in the main method. For each row, the CompositeTable calls the refresh method, passing in a row offset and a Row object. The method is then responsible for retrieving the appropriate model data and setting it on the Row object for display.

9 of 20 | Previous | Next

Comments



Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Open source
ArticleID=206190
TutorialTitle=An Eclipse Nebula widgets primer
publish-date=04172007
author1-email=scott@clientjava.com
author1-email-cc=
author2-email=iblivin@gmail.com
author2-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Try IBM PureSystems. No charge.