bundles/org.eclipse.platform.doc.isv/guide/swt_widgets_controls.htm - gerrit/platform/eclipse.platform.common - Git at Google

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML>
 <HEAD>

 <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >

 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

 <LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
 <TITLE>Controls</TITLE>

 <link rel="stylesheet" type="text/css" HREF="../book.css">
 </HEAD>
 <BODY BGCOLOR="#ffffff">

 <H3>Controls</H3>

 <p>A <a href="../reference/api/org/eclipse/swt/widgets/Control.html"><strong>Control</strong></a>
 is a widget that you can create and place anywhere you want in your widget
 parent/child tree.  The <a href="../reference/api/org/eclipse/swt/package-summary.html">SWT
 API reference</a> and examples contains detailed information about the
 different kinds of controls and their usage.  The
 <strong><a href="../reference/api/org/eclipse/swt/widgets/package-summary.html">org.eclipse.swt.widgets</a></strong>
 package defines the core set of widgets in SWT.  The following table summarizes
 the concrete types of controls provided in this package.</p>


 <table border="1" width="600">
 <colgroup>
     <col width="34%">
     <col width="66%">
 </colgroup>
 <tr>
 <th><div CLASS="CellHeading">Widget</div></th>
 <th><div CLASS="CellHeading">Purpose</div></th>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/browser/Browser.html">Browser</a></strong></td>
 <td>Control containing a native HTML renderer.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Button.html">Button</a></strong></td>
 <td>Selectable control that issues notification when pressed and/or
 released.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Canvas.html">Canvas</a></strong></td>
 <td>Composite control that provides a surface for drawing arbitrary graphics.
 Often used to implement custom controls.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Caret.html">Caret</a></strong></td>
 <td>An i-beam that is typically used as the insertion point for text.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Combo.html">Combo</a></strong></td>
 <td>Selectable control that allows the user to choose a string from a list of
 strings, or optionally type a new value into an editable text field.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Composite.html">Composite</a></strong></td>
 <td>Control that is capable of containing other widgets.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolBar.html">CoolBar</a></strong></td>
 <td>Composite control that allows users to dynamically reposition the cool items
 contained in the bar.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolItem.html">CoolItem</a></strong></td>
 <td>Selectable user interface object that represents a dynamically positionable
 area of a cool bar.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Group.html">Group</a></strong></td>
 <td>Composite control that groups other widgets and surrounds them with an
 etched border and/or label.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Label.html">Label</a></strong></td>
 <td>Non-selectable control that displays a string or an image.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Link.html">Link</a></strong></td>
 <td>Selectable control that displays a text with links.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/List.html">List</a></strong></td>
 <td>Selectable control that allows the user to choose a string or strings from a
 list of strings.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Menu.html">Menu</a></strong></td>
 <td>User interface object that contains menu items.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/MenuItem.html">MenuItem</a></strong></td>
 <td>Selectable user interface object that represents an item in a menu.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/ProgressBar.html">ProgressBar</a></strong></td>
 <td>Non-selectable control that displays progress to the user, typically in the
 form of a bar graph.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Sash.html">Sash</a></strong></td>
 <td>Selectable control that allows the user to drag a rubber banded outline of
 the sash within the parent window.  Used to allow users to resize child widgets
 by repositioning their dividing line.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Scale.html">Scale</a></strong></td>
 <td>Selectable control that represents a range of numeric values.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/ScrollBar.html">ScrollBar</a></strong></td>
 <td>Selectable control that represents a range of positive numeric values. Used
 in a Composite that has V_SCROLL and/or H_SCROLL styles.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Shell.html">Shell</a></strong></td>
 <td>Window that is managed by the OS window manager. Shells can be parented by
 a Display (top level shells) or by another shell (secondary shells).</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Slider.html">Slider</a></strong></td>
 <td>Selectable control that represents a range of numeric values.  A slider is
 distinguished from a scale by providing a draggable thumb that can adjust the
 current value along the range.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Spinner.html">Spinner</a></strong></td>
 <td>Selectable control that allows the user to enter and modify numeric
 values.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabFolder.html">TabFolder</a></strong></td>
 <td>Composite control that groups pages that can be selected by the user using
 labeled tabs.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabItem.html">TabItem</a></strong></td>
 <td>Selectable user interface object corresponding to a tab for a page in a tab
 folder.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Table.html">Table</a></strong></td>
 <td>Selectable control that displays a list of table items that can be selected
 by the user.  Items are presented in rows that display multiple columns
 representing different aspects of the items.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableColumn.html">TableColumn</a></strong></td>
 <td>Selectable user interface object that represents a column in a table.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableItem.html">TableItem</a></strong></td>
 <td>Selectable user interface object that represents an item in a table.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Text.html">Text</a></strong></td>
 <td>Editable control that allows the user to type text into it.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolBar.html">ToolBar</a></strong></td>
 <td>Composite control that supports the layout of selectable tool bar
 items.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolItem.html">ToolItem</a></strong></td>
 <td>Selectable user interface object that represents an item in a tool bar.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tracker.html">Tracker</a></strong></td>
 <td>User interface object that implements rubber banding rectangles.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tray.html">Tray</a></strong></td>
 <td>Represents the system tray that is part of the task bar status area on some
 operating systems.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TrayItem.html">TrayItem</a></strong></td>
 <td>Selectable user interface object that represents an item in the operating
 system's system tray.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tree.html">Tree</a></strong></td>
 <td>Selectable control that displays a hierarchical list of tree items that can
 be selected by the user.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeColumn.html">TreeColumn</a></strong></td>
 <td>Selectable user interface object that represents a column in a tree.</td>
 </tr>

 <tr>
 <td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeItem.html">TreeItem</a></strong></td>
 <td>Selectable user interface object that represents a hierarchy of tree items
 in a tree.</td>
 </tr>
 </table>

 </BODY>
 </HTML>
	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML>
	<HEAD>

	<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >

	<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
	<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">

	<LINK REL="STYLESHEET" HREF="../book.css" CHARSET="ISO-8859-1" TYPE="text/css">
	<TITLE>Controls</TITLE>

	<link rel="stylesheet" type="text/css" HREF="../book.css">
	</HEAD>
	<BODY BGCOLOR="#ffffff">

	<H3>Controls</H3>

	<p>A <a href="../reference/api/org/eclipse/swt/widgets/Control.html"><strong>Control</strong></a>
	is a widget that you can create and place anywhere you want in your widget
	parent/child tree. The <a href="../reference/api/org/eclipse/swt/package-summary.html">SWT
	API reference</a> and examples contains detailed information about the
	different kinds of controls and their usage. The
	<strong><a href="../reference/api/org/eclipse/swt/widgets/package-summary.html">org.eclipse.swt.widgets</a></strong>
	package defines the core set of widgets in SWT. The following table summarizes
	the concrete types of controls provided in this package.</p>


	<table border="1" width="600">
	<colgroup>
	<col width="34%">
	<col width="66%">
	</colgroup>
	<tr>
	<th><div CLASS="CellHeading">Widget</div></th>
	<th><div CLASS="CellHeading">Purpose</div></th>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/browser/Browser.html">Browser</a></strong></td>
	<td>Control containing a native HTML renderer.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Button.html">Button</a></strong></td>
	<td>Selectable control that issues notification when pressed and/or
	released.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Canvas.html">Canvas</a></strong></td>
	<td>Composite control that provides a surface for drawing arbitrary graphics.
	Often used to implement custom controls.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Caret.html">Caret</a></strong></td>
	<td>An i-beam that is typically used as the insertion point for text.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Combo.html">Combo</a></strong></td>
	<td>Selectable control that allows the user to choose a string from a list of
	strings, or optionally type a new value into an editable text field.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Composite.html">Composite</a></strong></td>
	<td>Control that is capable of containing other widgets.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolBar.html">CoolBar</a></strong></td>
	<td>Composite control that allows users to dynamically reposition the cool items
	contained in the bar.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/CoolItem.html">CoolItem</a></strong></td>
	<td>Selectable user interface object that represents a dynamically positionable
	area of a cool bar.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Group.html">Group</a></strong></td>
	<td>Composite control that groups other widgets and surrounds them with an
	etched border and/or label.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Label.html">Label</a></strong></td>
	<td>Non-selectable control that displays a string or an image.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Link.html">Link</a></strong></td>
	<td>Selectable control that displays a text with links.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/List.html">List</a></strong></td>
	<td>Selectable control that allows the user to choose a string or strings from a
	list of strings.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Menu.html">Menu</a></strong></td>
	<td>User interface object that contains menu items.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/MenuItem.html">MenuItem</a></strong></td>
	<td>Selectable user interface object that represents an item in a menu.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ProgressBar.html">ProgressBar</a></strong></td>
	<td>Non-selectable control that displays progress to the user, typically in the
	form of a bar graph.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Sash.html">Sash</a></strong></td>
	<td>Selectable control that allows the user to drag a rubber banded outline of
	the sash within the parent window. Used to allow users to resize child widgets
	by repositioning their dividing line.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Scale.html">Scale</a></strong></td>
	<td>Selectable control that represents a range of numeric values.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ScrollBar.html">ScrollBar</a></strong></td>
	<td>Selectable control that represents a range of positive numeric values. Used
	in a Composite that has V_SCROLL and/or H_SCROLL styles.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Shell.html">Shell</a></strong></td>
	<td>Window that is managed by the OS window manager. Shells can be parented by
	a Display (top level shells) or by another shell (secondary shells).</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Slider.html">Slider</a></strong></td>
	<td>Selectable control that represents a range of numeric values. A slider is
	distinguished from a scale by providing a draggable thumb that can adjust the
	current value along the range.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Spinner.html">Spinner</a></strong></td>
	<td>Selectable control that allows the user to enter and modify numeric
	values.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabFolder.html">TabFolder</a></strong></td>
	<td>Composite control that groups pages that can be selected by the user using
	labeled tabs.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TabItem.html">TabItem</a></strong></td>
	<td>Selectable user interface object corresponding to a tab for a page in a tab
	folder.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Table.html">Table</a></strong></td>
	<td>Selectable control that displays a list of table items that can be selected
	by the user. Items are presented in rows that display multiple columns
	representing different aspects of the items.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableColumn.html">TableColumn</a></strong></td>
	<td>Selectable user interface object that represents a column in a table.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TableItem.html">TableItem</a></strong></td>
	<td>Selectable user interface object that represents an item in a table.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Text.html">Text</a></strong></td>
	<td>Editable control that allows the user to type text into it.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolBar.html">ToolBar</a></strong></td>
	<td>Composite control that supports the layout of selectable tool bar
	items.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/ToolItem.html">ToolItem</a></strong></td>
	<td>Selectable user interface object that represents an item in a tool bar.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tracker.html">Tracker</a></strong></td>
	<td>User interface object that implements rubber banding rectangles.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tray.html">Tray</a></strong></td>
	<td>Represents the system tray that is part of the task bar status area on some
	operating systems.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TrayItem.html">TrayItem</a></strong></td>
	<td>Selectable user interface object that represents an item in the operating
	system's system tray.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/Tree.html">Tree</a></strong></td>
	<td>Selectable control that displays a hierarchical list of tree items that can
	be selected by the user.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeColumn.html">TreeColumn</a></strong></td>
	<td>Selectable user interface object that represents a column in a tree.</td>
	</tr>

	<tr>
	<td><strong><a href="../reference/api/org/eclipse/swt/widgets/TreeItem.html">TreeItem</a></strong></td>
	<td>Selectable user interface object that represents a hierarchy of tree items
	in a tree.</td>
	</tr>
	</table>

	</BODY>
	</HTML>