WkColumnView

The WkColumnView class defines a single column in an WkTableWidgetView or WkColumnarListBoxView widget. In addition to details about the look and feel of the column, it also provides get and set selectors which the application may use to specify the cell value for an item in that column and a list selector for specifying a dropdown list of values for a cell. The cell values may be further augmented through a cell value event. The column also provides events to notify the application when a cell is about to be edited and when the edit is about to end.

Protocol

autosize: aBoolean
Specifies whether the column width should be autosized.

 

attributeName: aSymbol
Specifies selector sent to the row object to retrieve the data for the cell.

 

characterValidation: aSymbol
Specifies the character validation function to use with values entered into cells within the column.

Default: #okAny: (Any)

Valid resource values:

#ok20Comma10: (20Comma10) - Validates whether each character is a valid for a 20,10 field.

#ok7Comma2: (7Comma2) - Validates whether each character is a valid for a 7,2 field.

#ok7Comma4: (7Comma4) - Validates whether each character is a valid for a 7,4 field.

#okAlpha: (Alpha) - Validates whether each character is a valid alpha character ($A - $Z, $a - $z or space).

#okAlphaNoSpace: (AlphaNoSpace) - Validates whether each character is a valid alpha character ($A - $Z, $a - $z).

#okAlphaNumeric: (AlphaNumeric) - Validates whether each character is a valid alpha-numeric character ($A - $Z, $a - $z, $0 - $9, or space).

#okAlphaNumericNoSpace: (AlphaNumericNoSpace) - Validates whether each character is a valid alpha character ($A - $Z, $a - $z, $0 - $9).

#okAny: (Any) - Any character is valid.

#okBoolean: (Boolean) - Validates whether each character is a valid Boolean value (e.g., T, t, F, f, Y, y, N, or n).

#okCurrency: (Currency) - Validates whether each character is a valid currency value.

#okInteger: (Integer) - Validates whether each character is a valid Integer value.

#okNumeric: (Numeric) - Validates whether each character is a valid numeric value.

#okPositive10Comma10: (Positive10Comma10) - Validates whether each character is a valid for a positive 10,10 field.

#okPositiveInteger: (PositiveInteger) - Validates whether each character is a valid positive Integer.

#okPositiveNumeric: (PositiveNumeric) - Validates whether each character is a valid positive numeric value.

 

disabledAttributeName: aSymbol
Specifies selector sent to the row object to determine whether a cell should be disabled.

 

editable: aBoolean
Specifies whether the cells in this column are editable.

 

etched: aBoolean
Specifies whether this column is to be etched.

 

heading: aString
Specifies the heading object to be displayed at the top of the column.

 

headingEtched: aBoolean
Specifies whether this column’s heading is to be etched.

 

hide
Hide the column

 

horizontalAlignment: anInteger
Specifies how the cells in this column should be aligned horizontally.

Default: XmALIGNMENTBEGINNING (Left)

Valid resource values:

XmALIGNMENTBEGINNING (Left) - Align the cells to the left.

XmALIGNMENTCENTER (Center) - Align the cells to the center.

XmALIGNMENTEND (Right) - Align the cells to the right.

 

horizontalHeadingAlignment: anInteger
Specifies how this column’s heading should be aligned horizontally.

Default: XmALIGNMENTBEGINNING (Left)

Valid resource values:

XmALIGNMENTBEGINNING (Left) - Align the heading to the left.

XmALIGNMENTCENTER (Center) - Align the heading to the center.

XmALIGNMENTEND (Right) - Align the heading to the right.

 

listAttributeName: aSymbol
Specifies selector sent to the row object to retrieve a list of values to populate the drop down list in the cell.

 

minWidth: anInteger
Specifies the minimum width of the column in pixels. This minimum applys to autosizing and user resizing operations.

 

reorderable: aBoolean
Specifies whether the column is reorderable (can be draged left and right).

 

refreshColumnValues
Refresh all of the cells in the column

 

resizable: aBoolean
Specifies whether the column is resizable by the user. If so, the user can drag the right side of the column heading to change the column width

 

show
Show the column

 

showInUse: aBoolean
Specifies whether the column should show the inUse emphasis for each item.

 

sortable: aBoolean
Specifies whether the column is sortable.

 

verticalAlignment: anInteger
Specifies how the cells and heading in this column should be aligned vertically.

Default: XmALIGNMENTBEGINNING (Top)

Valid resource values:

XmALIGNMENTBEGINNING (Top) - Align the cells to the top.

XmALIGNMENTCENTER (Center) - Align the cells to the vertical center.

XmALIGNMENTEND (Bottom) - Align the cells to the bottom.

 

verticalSeparatorThickness: anInteger
Specifies the thickness of the line shown to the right of each cell in the column.

 

width: anInteger
Specifies the width of the column in pixels. This does not includes the width of any emphasis or vertical separator.

Events

About To Begin Edit
These events are triggered when an item is about to be edited.

 

About To End Edit
These events are triggered when an item is done being edited.

 

Cell Value Requested
These events are triggered when an item’s cell value is needed for this column.

 

Heading Cell Value Requested
These events are triggered when heading cell value is needed for this column.

 

PopUp Menu Request
These events are triggered when the column needs its popup menu.

 

Resized
These events are triggered when the column is resized.