Table
of Contents Previous
Section
Configuring the Display Group
A display group must be configured in order for it
to be created and initialized automatically when the component is initialized.
Display groups are instantiated from an archive file (with the extension
.woo) that's stored in the component. You shouldn't edit .woo
files by hand; they're maintained by WebObjects Builder.
In the object browser,
means that the display group has been configured. A
means that it has not been configured, and so the variable isn't automatically
created. A configured display group shows its keys and actions in the second
column of the object browser. You can bind them to elements in your program.
To configure a display group (or change its configuration),
double-click its name to open the Display Group Options panel.
In this panel, you specify the following information:
-
Entity: The Entity combo box has a list of entities from the models
in your project. You can select one from the list or type the name.
-
Has detail data source: Check this to create a detail display group.
See "Creating a Detail Display Group"
for more information.
-
Entries per batch: Set a non-zero value here to specify the number
of records to be displayed at once. When the value is zero, all records
are displayed.
-
Qualification: When displaying records according to a query, this
setting determines whether to display records that begin with, end with,
or contain the item specified.
-
Fetches on load: When you check this option, the display group fetches
all its objects as soon as the component is loaded into the application.
-
Sorting: You select an attribute by which to sort your displayed
objects from the pop-up list, and use the radio buttons to select the order
of sorting.
Table
of Contents Next
Section