Documentation Archive Developer
Search
Table of Contents Previous Section

WOPopUpButton

Synopsis

WOPopUpButton { list=anArray; [item=anItem; value=displayedValue;] [selection=theSelection;] [name=fieldName;] [disabled=YES|NO;] ... };

Description

WOPopUpButton displays itself as a selection list that allows the user to select only one item at a time. The related element WOBrowser is similar to WOPopUpButton except that it allows the user to select more than one item at a time.

list
Array of objects from which the WOPopUpButton derives its values. For example, colleges could name the array containing objects that represent individual schools.
item
Identifier for the elements of the list. For example, aCollege could represent an object in the colleges array.
value
Value to display in the selection list; for example, aCollege.name for each college object in the list.
selection
Object that the user chose from the selection list. For the college example, selection would be a college object.
name
Name that uniquely identifies this element within the form. You can specify a name or let WebObjects automatically assign one at runtime.
disabled
If disabled evaluates to YES, this element appears in the page but is not active. That is, selection does not contain the user's selection when the page is submitted.

Examples

Forms and input elements

Table of Contents Next Section