addChildSelector: aSymbol
Specifies a single argument selector used to add a child to an item.
addedAt: position count:
countItem(s) were added to the collection of root items at the specified position. The position is specified as an index in the collection of root items only. Refresh the list.
applicationDrawnBackground: aBoolean
Specifies whether the application wants the Draw Background Callback to fire when an item’s background needs to be drawn. If this value is false, then the widget will draw the normal default background for each selected and non-selected item.
buttonPolicy: anIntegerSpecifies how the hierarchy buttons should be displayed (e.g., as buttons, as triangles or not at all.
cancelEdit
Call the end edit callbacks and proceed with a cancel of the edit if approved. Hide the edit widget only if the end was approved. The last committed value for the edited item will be provided as the newValue during the endEditCallback. Edit changes are committed when the updateEdit or endEdit API is invoked. This method will answer whether or not the cancelEdit was approved.
childrenSelector: aSymbolSpecifies a unary selector sent to an item to return its children.
collapsePos: position notify: notifyCollapse an item in the list by position to hide its children. This API can be used after the widget is created. When an item's children are collapsed, those children that are selected will be deselected, since the selected state of the children will no longer be visible. If children are deselected, the selection callback will be fired. The selection callback will be fired before the item is collapsed and before the expandCollapse callback.
position - Specifies the Integer position of the item to be collapsed. A value of 1 indicates that the first item in the list is collapsed; a value of 2 indicates that the second item is collapsed; and so on. A value of 0 indicates that the last item in the list is collapsed.
notify - Specifies whether to fire the expandCollapseCallback .
colorSelector: aSymbolSpecifies a unary selector sent to an item to return its label color.
conformingObjectSelector: aSymbolSpecifies a single argument selector used to determine whether an object can be added as a child of an existing object.
deferRefreshWhile: aBlockMinimize the repainting done while
aBlock is being evaluated. This message may be safely nested. This message does not guarantee minimal repainting. Rather, it serves as a hint to the widget so that, where possible and appropriate, repainting can be deferred until the block has finished being evaluated.
deletedAt: position count:
countItem(s) were deleted from the collection of root items at the specified position. The position is specified as an index in the collection of root items only. Refresh the list.
deselectAllItemsDeselect and remove all elements from the selectedItems list. A selection callback is not triggered.
deselectItem:
itemDeselect and remove the specified item from the selected list. A selection callback is not triggered.
deselectPos: positionDeselect and remove an item from the selected list by position. A selection callback is not triggered.
editItemAt: indexBegin editing the item at the index given. This causes the beginEdit callbacks to be called for the item. The application must hook this callback and set doit: true for editing to take place. If editing is already in progress, the endEdit API will be invoked and if the end edit is successful, editing for the new item will begin.
emphasisPolicy: anInteger
Specifies whether to draw the icon and label emphasis as one single rectangle or as two separate rectangles.
endEdit
Call the end edit callbacks and proceed with an end to the edit if approved. Hide the edit widget only if the end was approved. Answer whether the end was approved.
expandCollapsePos: position notify: notifyExpand or collapse an item in the list by position to show or hide its children. If it is expanded, collapse it. If it is collapsed, expand it. This API can be used after the widget is created. When an item's children are collapsed, those children that are selected will be deselected, since the selected state of the children will no longer be visible. If children are deselected, the selection callback will be fired. The selection callback will be fired before the item is collapsed and before the expandCollapse callback.
position - Specifies the Integer position of the item to be expanded or collapsed. A value of 1 indicates that the first item in the list is expanded or collapsed; a value of 2 indicates that the second item is expanded or collapsed; and so on. A value of 0 indicates that the last item in the list is expanded or collapsed.
notify - Specifies whether to fire the expandCollapseCallback.
expandPos: position notify: notifyExpand an item in the list by position to show its children.
position - Specifies the Integer position of the item to be expanded or collapsed. A value of 1 indicates that the first item in the list is expanded or collapsed; a value of 2 indicates that the second item is expanded or collapsed; and so on. A value of 0 indicates that the last item in the list is expanded or collapsed.
notify - Specifies whether to fire the expandCollapseCallback.
getItemPos: positionAnswer the item in the list by position. This message answers a list item at the specified position or nil if position is greater than the size of the list. This message only accesses the list if the item is not visible.
getMatchPos: itemThis message returns an Array of Integer positions where a specified item is found in the items list. If the item does not occur in the list the resulting Array is empty.
getSelectedPosReturn an Array containing the positions of every selected item in the list.
hasChildrenSelector: aSymbolSet the unary selector sent to an item to return whether it has children.
hierarchyPolicy: hierarchyPolicy
Determines how the hierarchy is to be shown. This includes what the indentation level should be as well as whether to draw lines connecting the items and whether to show some kind of button beside items which have children. By default the hierarchyPolicy is an instance of EwHierarchyPolicy with lines set to true.
iconExpandSelector: aSymbolSpecifies a unary selector sent to an item to return its expanded icon.
iconSelector: aSymbolSpecifies a unary selector sent to an item to return its icon.
indentationWidth: anIntegerSpecifies how many pixels each level of the hierarchyy should be indented.
indexAtPoint: aPointAnswer the index of the item in the list which lies beneath the point given. If no item lies beneath the point or if the widget has not been drawn yet, then answer nil.
indexOf:
itemAnswer the index of the item given in the list or 0 if the item is not present in the list.
initialStateSelector: aSymbolSpecifies a unary selector sent to an item to return its initial state (expanded or not).
innerMargin: anInteger
Specifies the margin width to be used between each item’s icon and its label.
isExpandedPos: positionAnswer whether an item in the list by position is expanded to show its children.
itemAtPoint: aPointAnswer the item in the list which lies beneath the point given. If no item lies beneath the point, then answer nil.
itemCountSpecifies the total number of items. This number might not match XmNitems, since this number is the size of the expanded hierarchy. Item count is automatically updated whenever an element is added to or deleted from the list.
itemExists: itemAnswer whether a specified item is in the list.
itemHeight: anInteger
Specifies the height in pixels of items in the list. This includes the margin height on the top and bottom of the item as well as two pixels for emphasis.
itemIsVisible: itemCheck if a specified item is in the portion of the list that is currently visible. Answer true if it is even partially visible, false if it is not visible.
items: anOrderedCollection
An array of objects that are to be displayed as the list items.
itemsDo: aBlockEvaluate aBlock for each item in the receiver's list.
itemWidth: anIntegerSpecifies the width in pixels of items in the list. This includes the two pixels for emphasis.
lines: aBooleanSpecifies whether the widget should display hierarchy lines.
nameSelector: aSymbolSpecifies a unary selector sent to an item to return its name/label.
parentOfItem: anItemAnswer the parent of the item given in the hierarchy or false if it is not in the expanded hierarchy. Answer nil if it is a root item.
refreshHierarchyPos: positionRefresh an item in the list by position. Also re-obtain the item's children.
refreshNodeAt: positionRefresh the node at the given position. Answer whether or not a full refresh occurred.
refreshPos: positionRefresh an item in the list by position.
removeChildSelector: aSymbolSpecifies a single argument selector used to remove a child from an item.
scrollHorizontal: aBoolean
This resource specifies whether a horizontal scroll bar should be used for the list.
selectedItems: anOrderedCollection
An OrderedCollection of Objects that represents the list items that are currently selected, either by the user or the application.
selectItem: anItemSelect an item in the list. This message selects and adds the specified item to the current selected list. The cursor moves to the newly selected item.
selectItem: item notify: notifySelect an item in the list. This message selects and adds the specified item to the current selected list. The cursor moves to the newly selected item.
selectPos: position notify: notifySelect an item in the list by position. This message selects a list item at the specified position and adds it to the list of selected items.
setBottomItem: itemMake the given item the last visible item in the list. The item can be any valid item in the list.
setBottomPos: positionMake an item the last visible item in the list by position. This message makes the item at the specified position the last visible item in the list.
setItem:
itemMake the given item the first visible item in the list. The item can be any valid item in the list.
setPos: positionMake an item the first visible item in the list by position. This message makes the item at the given position the first visible position in the list.
topItemPosition: anIntegerSpecifies the Integer position of the item that is the first visible item in the list.
visibleItemCount
Specifies the number of items that can fit in the visible space of the list. Until the list is realized, this answers 0.
Browse Selection Callback
These callbacks are triggered when an item is selected in the browse selection mode. It is only valid when Selection Policy is Browse Select.
Children Callback
These callbacks are triggered when an item’s list of children is needed.
Extended Selection Callback
These callbacks are triggered when items are selected using the extended selection mode. It is only valid when Selection Policy is Extended Select.
Modify Verify Callback
These callbacks are triggered when the selection is about to be changed. The application may ‘undo’ the selection change by setting the doit field of the callData to false.
Multiple Selection Callback
These callbacks are triggered when an item is selected in multiple selection mode. It is only valid when Selection Policy is Multiple Select.
Single Selection Callback
These callbacks are triggered when an item is selected in single selection mode. It is only valid when Selection Policy is Single Select.
Visual Info Callback
These callbacks are triggered when an item’s icon, label and isInUse are needed. The application MUST hook this callback and set the callData icon to the CgIcon (or other renderable object) to be displayed as the icon for the item in callData item. It must also set the callData label to the String (or other renderable object) to be displayed as the label for the item.
Application Drawn Background
Specifies whether the application wants the Draw Background Callback to fire when an item’s background needs to be drawn. If this value is false, then the widget will draw the normal default background for each selected and non-selected item.
Border Width
Specifies the width of the border that surrounds the widget’s window on all four sides. The width is specified in pixels. A width of zero means that no border will show.
Button PolicySpecifies how the hierarchy buttons should be displayed (e.g., as buttons, as triangles or not at all.
Color SelectorSpecifies a unary selector sent to an item to return its label color.
Emphasis Policy
Specifies whether to draw the icon and label emphasis as one single rectangle or as two separate rectangles.
Enabled
Determines whether a widget will react to input events. Disabled (insensitive) widgets do not react to input events.
Icon SelectorSpecifies a unary selector sent to an item to return its icon.
Indentation WidthSpecifies how many pixels each level of the hierarchyy should be indented.
Initial State SelectorSpecifies a unary selector sent to an item to return its initial state (expanded or not).
Inner Margin
Specifies the margin width to be used between each item’s icon and its label.
Item Height
Specifies the height in pixels of items in the list. This includes the margin height on the top and bottom of the item as well as two pixels for emphasis.
Item Width
Specifies the width in pixels of items in the list. This includes the two pixels for emphasis.
LinesSpecifies whether the widget should display hierarchy lines.
Name SelectorSpecifies a unary selector sent to an item to return its name/label.
Scroll Horizontal
This resource specifies whether a horizontal scroll bar should be used for the list.
Top Item Position
Specifies the Integer position of the item that is the first visible item in the list.
Visible
Maps the widget (makes visible) as soon as it is both realized and managed, if set to True. If set to False, the client is responsible for mapping and unmapping the widget.
Copyright 2005, 2015 Instantiations, Inc. All rights reserved.