Editing ColumnSelector bean properties
You specify and control the operation of the CellSelector bean by opening the property
sheet for the ColumnSelector bean and setting the values for the displayed properties. To open the
property sheet of a ColumnSelector bean on the Visual Composition Editor surface:
- Right click the ColumnSelector bean. The bean menu displays.
- Click Properties. The Properties sheet displays.
.
You can control:
- The name of the ColumnSelector bean. Specify the name as the beanName property
value.
- The name of the column to be selected from the source TableModel. The match on column
name is not case sensitive. Specify this in the columnName property
value. Check the Show Expert Features checkbox to display this property.
If the specified column name is blank or null, the selected column will be identified by columnNumber.
- The index of the column to be selected from the source TableModel. This column index
will only be used if the value of columnName is blank or null. Specify this in the columnNumber
property value.
- Whether the column name is to be included as the first element of column data. This only
has effect when column data are retrieved as String values. Specify this in the includeColumnName property
value. Check the Show Expert Features checkbox to display this property.
- Whether the row and column indexes are assumed to index from one. This property should
be set to true where the selection row and/or column properties are connected to a bean
property that indexes from one. If set to false, indexing is from zero. Specify this in
the indexFromOne property value. Check the Show Expert Features
checkbox to display this property.
- The maximum number of rows to be selected. You can select NO_MAXIMUM to indicate that
the last row of the selection should be the last row in the source TableModel. Specify
this in the maximumRows property value.
- Which data access property will be notified of changes by a propertyChange event.
Selectors are able to convert source data into a
variety of data types, each of which has a corresponding bound property. All of these
properties are theoretically altered when the selector data source or selection criteria
are changed. However, it would be very inefficient to generate propertyChange events for
all these properties. So the property of interest may be specified, limiting property
change events to a single property. By default, no property change events are generated.
Specify this in the notificationType property value. Check the Show Expert
Features checkbox to display this property.
- The index of the row to start the selection from the source TableModel. Specify this in
the startRowNumber property value.
- The data type that should be used when populating vectors in response to a vector
property query. Some beans may require data to be fed to them in a vector, and may further
expect the elements in the vector to be of a specific type. Where this is the case the
notificationType property may be set to Selector.VECTOR to cause propertyChange events to
be generated for the vector property. Specify this in the vectorContentType property
value. Check the Show Expert Features checkbox to display this property.

Selector Beans

Using Selector beans

ColumnSelector
