The object interactor handles any events occurring on the object with which the interactor is associated, provided the view interactor has enabled the use of object interactors. You can check this by means of the isUsingObjectInteractor method or modify it with the setUsingObjectInteractor method. Object interactors are enabled by default.

How to Associate an Object Interactor with a Representation Object in the Table

You can associate an object interactor with a representation object by using either CSS or the API. The following CSS extract shows how to proceed:

Table {
  interactor: true;
}
 
object."ilog.tgo.model.IltNetworkElement" {
  interactor: @+objInteractor;
}
Subobject#objInteractor {
  class: 'ilog.cpl.interactor.IlpDefaultObjectInteractor';
}

The same configuration can be achieved through the API, as follows:

IlpTable table = // ... 
IltNetworkElement ne = //... 
IlpTableController tableController = table.getController();
// Create an object interactor
IlpObjectInteractor objectInteractor = new IlpDefaultObjectInteractor();
tableController.setObjectInteractor(ne, objectInteractor);
// Configuring the specific object interactor is similar to configuring 
// a view interactor. 
objectInteractor.setGestureAction(IlpGesture.BUTTON3_CLICKED, new MyAction());

How to Associate an Object Interactor with a Table Cell

You can associate an object interactor with a table cell, which is identified by a representation object and an attribute, by using either CSS or the API. The following CSS extract shows how to customize a specific object interactor to the cell that represents the name attribute:

Table {
   interactor: true;
}
object."ilog.tgo.model.IltNetworkElement/name" {
   interactor: @+objInteractor;
}
Subobject#objInteractor {
   class: 'ilog.cpl.interactor.IlpDefaultObjectInteractor';
}

The same configuration can be achieved through the API, as follows:

IlpTable table = // ...
IltNetworkElement ne = //...
IlpAttribute attribute = IltNetworkElement.NameAttribute;
IlpTableController tableController = table.getController();
// Create an object interactor
IlpObjectInteractor objectInteractor = new IlpDefaultObjectInteractor();
tableController.setObjectInteractor( ne, attribute, objectInteractor);

Handling the Selection

How to Handle Selection in the Table

IlpTable tableComponent = new IlpTable();
// Set a selection mode to select multiple entire rows
tableComponent.setSelectionMode(IlpTableSelectionMode.
  MULTIPLE_OBJECTS_SELECTION);

The following methods can be used to select business objects:

Fitting to Contents

How to Resize a Table

IlpTable tableComponent = new IlpTable();
// Apply the policy
tableComponent.setAutoResizeMode
  (IlpTableResizeMode.AUTO_RESIZE_LAST_COLUMN) ;
// Now, when a column or the entire table is resized, only the last column 
//is shrunk or expanded

Resizing Columns

The user can dynamically resize the columns in a table by dragging the right border of their header.

To resize a column by programming, use the following code, setting a size of 10 to the name column.

How to Resize Columns in a Table

IlpTable tableComponent = new IlpTable();
// This table will contain Network Elements
IlpClass acceptedClass = IltNetworkElement.GetIlpClass();
tableComponent.setAcceptedClass(acceptedClass);
...
// Retrieve the IlpAttribute corresponding to the name in 
// IltNetworkElement class
IlpAttribute name = acceptedClass.getAttribute("name");
TableComponent.getTableColumn(name).setPreferredSize(10);

Fixing Columns in a Table

How to Fix the Position of Columns in a Table

IlpTable tableComponent = new IlpTable();
...
// Fix 3 columns
tableComponent.setFixedColumnCount(3) ;
// Fix a 4th column
tableComponent.setFixedColumnCount(4) ;
// Unfix all columns
tableComponent.setFixedColumnCount(0) ;

Moving Columns

To rearrange the columns by programming, use the following code.

How to Rearrange Columns in a Table

IlpTable tableComponent = new IlpTable();
// This table will contain Network Elements
IlpClass acceptedClass = IltNetworkElement.GetIlpClass();
tableComponent.setAcceptedClass(acceptedClass);
...
// Retrieve the IlpAttribute corresponding to the name in 
// IltNetworkElement class
IlpAttribute name = acceptedClass.getAttribute("name");
// Column "name" will take the second position
tableComponent.setColumnIndex(name,1);

Searching for a String in a Table

You can search for a string in a table by using the searchValue method. Searching is performed on the values displayed in the cells (that is, with styles applied), not on the raw values stored by the representation objects. The searchValue method returns the coordinates of the first cell containing the string, starting from the specified cell.

If the startingcell parameter is null, the search starts from the first cell in the table.

The search is not case sensitive if the parameter caseMatching is false.

The search can be performed row by row (scanRowByRow parameter is true), or column by column (scanRowByRow parameter is false).

The method returns null if the searched value cannot be found in the scope of the search.

How to Search for a String in a Table

IlpTable tableComponent = new IlpTable();
...
IlpCellCoordinates cellFound
   = tableComponent.searchValue("a string", // searched string
                                null,       // starting cell
                                false,      // scan row by row
                                false);     // case matching

Showing or Hiding Columns in a Table

Here is an example.

How to Show or Hide Columns in a Table

IlpTable tableComponent = new IlpTable();
// This table will contain Network Elements
IlpClass acceptedClass = IltNetworkElement.GetIlpClass();
tableComponent.setAcceptedClass(acceptedClass);
...
// Retrieve the IlpAttribute corresponding to the name in
// IltNetworkElement class
IlpAttribute nameAttr = acceptedClass. getAttribute("name");
// Hide the column
tableComponent.setColumnVisible(nameAttr, false) ;
// Show the column again
tableComponent.setColumnVisible(nameAttr, true) ;

Sorting Columns

Columns can be sorted in ascending or descending order, interactively or by programming.

Interactively, the user clicks a column header once to sort it in ascending order, twice to sort it in descending order, and three times for no sorting at all. Using the Shift key while clicking the column header adds this column as a sorting criterion, whereas otherwise the column is set as the only sorting criterion.

By programming, you can use the following methods:

Adding New Columns to the Table

It is possible to add custom attributes as new columns in a table component, as illustrated by the following code sample.

How to Add Columns to a Table

// Create a datasource
IltDefaultDataSource dataSource = new IltDefaultDataSource();
// Read an XML file into the datasource
dataSource.parse("alarms.xml");
// Create a table component
IlpTable tableComponent = new IlpTable();
// Get the Alarm class
IlpClass alarmClass =
  IltSystem.GetDefaultContext().getClassManager().getClass("Alarm");
// Set the datasource to the component, and show instances 
// of the Alarm class
tableComponent.setDataSource(dataSource, alarmClass);
// Add custom attributes
// Get the existing severity attribute
IlpAttribute severity = alarmClass.getAttribute("perceivedSeverity");
// Create a 'Short severity' attribute that represents the severity 
// in a concise way
IlpAttribute shortSeverityAttribute = 
  new IlpReferenceAttribute("shortSeverity", severity);
tableComponent.addAttribute(shortSeverityAttribute);

Filtering Rows

To perform the filtering, you can use the method setFilter at two different levels:

Excluding Table Rows

How to Specify Excluded Classes in the Table Component

Adapter {
  excludedClasses[0]: "ilog.tgo.model.IltAlarm";
  excludedClasses[1]: "ilog.tgo.model.IltLed";
}