How to Use the Data Controls Panel

2-12 Java EE Developers Guide for Oracle Application Development Framework

2.3.1 How to Use the Data Controls Panel

JDeveloper provides you with a predefined set of UI components from which to choose for each data control item you drop. To use the Data Controls panel to create UI components: 1. Select an item in the Data Controls panel and drag it onto the visual editor for your page. For a definition of each item in the panel, see Table 2–1 . 2. From the ensuing context menu, select a UI component. When you drag an item from the Data Controls panel and drop it on a page, JDeveloper displays a context menu of all the default UI components available for the item you dropped. Figure 2–6 shows the context menu displayed when an accessor returned collection from the Data Controls panel is dropped on a page. Method Return Represents an object that is returned by a custom method. The returned object can be a single value or a collection. A method return appears as a child under the method that returns it. The objects that appear as children under a method return can be attributes of the collection, other methods that perform actions related to the parent collection, or operations that can be performed on the parent collection. For single values: text fields and selection lists. For collections: forms, tables, trees, and range navigation components. When a single-value method return is dropped, the method is not invoked automatically by the framework. A user either has to also create an invoke action as an executable, or drop the corresponding method as a button to invoke the method. Operation Represents a built-in data control operation that performs actions on the parent object. Data control operations are located in an Operations node under collections or method returns. The operations that are children of a particular collection or method return operate on those objects only. If an operation requires one or more parameters, they are listed in a Parameters node under the operation. Command components such as buttons or links. For information about creating command components from operations, see Section 3.4, Incorporating Range Navigation into Forms. Parameter Represents a parameter value that is declared by the method or operation under which it appears. Parameters appear in the Parameters node under a method or operation. Label, text, and selection list components. Table 2–1 Cont. The Data Controls Panel Icons and Object Hierarchy Icon Name Description Used to Create... Using ADF Model Data Binding in a Java EE Web Application 2-13 Figure 2–6 Data Controls Panel Context Menu Depending on the component you select from the context menu, JDeveloper may display a dialog that enables you to define how you want the component to look. The resulting UI component appears in the JDeveloper visual editor, as shown in Figure 2–7 . Figure 2–7 Databound UI Component: ADF Table

2.3.2 What Happens When You Use the Data Controls Panel to Create UI Components