Functional Areas of a Gantt Chart

Using ADF Gantt Chart Components 28-7 When a user interaction involves a change in data, the Gantt chart processes the change by performing validation, event handling, and update of the data model. Validation ensures that the data submitted meets basic requirements, for example, that a date is valid and does not fall into a nonworking time period. When validation fails, the update of the data model is omitted, and an error message is returned. When a Gantt chart server-side event is fired, an event with validated information about the change is sent to the registered listener. The listener is then responsible for updating the underlying data model. A customized event handler can be registered by specifying a method binding expression on the dataChangeListener attribute of the Gantt chart component. Server-side events supported by the Gantt chart include: ■ Update of data in the table cells of the Gantt chart table region ■ Create, update, delete, move, cut, copy, paste, indent, outdent of tasks ■ Reassignment of resource by dragging the task bar from one row to another ■ Drag the task bar to another date ■ Extend the duration of a task ■ Link or unlink tasks ■ Select a row or multiple rows in the Gantt chart table region ■ Undo or redo of user actions ■ Double-click on a task bar Users can filter the data in a Gantt chart using a dropdown list from the toolbar. You can create a custom filter.

28.3.1 Navigating in a Gantt Chart

You can browse through Gantt chart regions by scrolling, or you can access a specific date in the chart region. You can also control if columns in the table region are visible.

28.3.1.1 Scrolling and Panning the List Region or the Chart Region

The Gantt chart design lets you perform horizontal scrolling of the table and the chart regions independently. This is especially helpful when you want to hold specific task or resource information constant in the table region while scrolling through multiple time periods of information in the chart region. Users can also zoom in and out on the time scale of a Gantt chart by holding the Ctrl key and using the mouse scroll wheel. In project and scheduling Gantt charts, users can pan the chart area by dragging it vertically and horizontally using the mouse. A move cursor displays when the user clicks inside the chart area, other than on a task.

28.3.1.2 How to Navigate to a Specific Date in a Gantt Chart

You can move the chart region of the Gantt chart rapidly to a specific date. To navigate to a specific date in a Gantt chart: 1. From the View menu, choose Go to Date. 2. In the Go to Date dialog, specify the desired date by clicking the Select Date icon and indicating the date in the calendar. 28-8 Web User Interface Developers Guide for Oracle Application Development Framework

3. Click OK.

The display of the chart region of the Gantt chart begins at the date you requested.

28.3.1.3 How to Control the Visibility of Columns in the Table Region

By default, all the columns that you define when you create a databound Gantt chart are visible in the table region. You can selectively cause one or more of these columns to be hidden. To control the display of columns in the table region of a Gantt chart: 1. From the View menu, select List Pane. 2. From the context menu, select Columns. 3. In the Columns menu, deselect any column that you want to be hidden in the table region of the Gantt chart. You can also select any column that you want to make visible in the table region.

28.3.2 How to Display Data in a Hierarchical List or a Flat List

If a Gantt chart is using a hierarchical data model, then you have the option of displaying all the Gantt chart data in a collapsed form or in an expanded form. To control the display of Gantt chart data in a list: 1. From the View menu, select List Pane. 2. From the ensuing menu, select either Show As List, for an expanded list, or Show As Hierarchy , for a collapsed list.

28.3.3 How to Change the Gantt Chart Time Scale

You can change the time scale display in a Gantt chart and you can zoom in and out on a time axis to display the chart region in different time units. You can also use a specialized zoom-to-fit feature in which you select the amount of time that you want to display in the chart region without a need to scroll the chart. To change the settings of a time axis: 1. From the View menu, select Time Scale. 2. In the ensuing Time Scale dialog, in the Time Unit column, select a new unit value for either the major axis, the minor axis, or both axes. A sample box displays sample settings for the time unit that you select. Figure 28–7 shows the Time Scale dialog. Note: You must keep at least one column visible in the table region.