Instances of this class are controls that allow the user to choose an item from a list of items, or optionally enter a new value by typing it into an editable text field. Often, <code>Combo</code>s are used in the same place where a single selection <code>List</code> widget could be used but space is limited. A <code>Combo</code> takes less space than a <code>List</code> widget and shows similar information. <p> Note: Since <code>Combo</code>s can contain both a list and an editable text field, it is possible to confuse methods which access one versus the other (compare for example, <code>clearSelection()</code> and <code>deselectAll()</code>). The API documentation is careful to indicate either "the receiver's list" or the "the receiver's text field" to distinguish between the two cases. </p><p> Note that although this class is a subclass of <code>Composite</code>, it does not make sense to add children to it, or set a layout on it. </p> <dl> <dt><b>Styles:</b></dt> <dd>DROP_DOWN, READ_ONLY, SIMPLE</dd> <dt><b>Events:</b></dt> <dd>DefaultSelection, Modify, Selection, Verify</dd> </dl> <p> Note: Only one of the styles DROP_DOWN and SIMPLE may be specified. </p><p> IMPORTANT: This class is <em>not</em> intended to be subclassed. </p>
Copyright (c) 2000, 2008 IBM Corporation 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: IBM Corporation - initial API and implementation Port to the D programming language: Frank Benoit <benoit@tionex.de>