Container Icon List events
aboutToBeginEdit
The aboutToBeginEdit event signals that the part is about to be edited.
aboutToCloseWidget
The aboutToCloseWidget event signals that the part is about to be closed.
If you need to perform any actions just before the window closes, connect the aboutToCloseWidget event of the Window part to an action in your part.
aboutToEndEdit
The aboutToEndEdit event signals that the part being edited is about to end its editing action.
aboutToMapWidget
The aboutToMapWidget event signals that the part is about to be shown on the screen. If you need to take any actions or set any visual attributes on the part before it is shown, connect to this event. If you hide and show the part rather than closing and opening it (typically for performance reasons), you can use this event to refresh the part data before it appears.
aboutToOpenWidget
The aboutToOpenWidget event signals that the part is about to be opened. This event is signaled just before the part is displayed on the screen.
If you need to perform any actions just before the window opens, connect the aboutToOpenWidget event of the Window part to an action in your part.
aboutToUnmapWidget
The aboutToUnmapWidget event signals that the part is about to be hidden.
attributeName
The attributeName event signals the part that the name of the attribute within the collection of items is displayed in the part.
backgroundColor
The backgroundColor event signals the part that the background color has changed.
borderWidth
The borderWidth event signals the part that the width of the border, specified in pixels, has changed.
closedWidget
The closedWidget event signals that the part has been closed.
configuredWidget
The configuredWidget event signals that the part has been moved or resized.
defaultActionRequested
The defaultActionRequested event signals that the user pressed the line feed key (typically the Enter key) while the part had the focus or the user double-clicked mouse button 1 on a part.
defaultItemIconDescriptor
An event of defaultItemIconDescriptor indicates a change in the attribute representing the icon descriptor to use as the default icon for the items displayed in the part.
destroyedPart
The destroyedPart event signals that the part and its children have been destroyed. Any system resources associated with the destroyed parts have been released.
editable
An editable event signals that the part's contents can be edited at run time.
emphasisPolicy
An emphasisPolicy event indicates a change in how the icon and label are emphasized within a container part. Valid values are:
XmTOGETHER
Specifies that you want the rectangle around both the icon and its label together.
XmSEPARATE
Specifies you want two separate rectangles, one around the icon and one around the label.
enabled
The enabled event signals that the part is available for selection.
fontName
The fontName event signals the part which font to use for the text displayed in the part.
foregroundColor
The foregroundColor event signals the part the name of the RGB color, to use, for the foreground of the part.
framingSpec
The framingSpec event signals the part that the edge specifications for the part have changed. The edge specifications determine the width, height, and position of the part.
gettingFocus
The gettingFocus event signals that the part is getting focus, or becoming active. If the part has focus, keyboard input is enabled.
The gettingFocus event acts differently depending on which part is receiving the event. For example, if you connect the gettingFocus event to a Window part, the window will come to the foreground and be the active window. Also, if you connect the gettingFocus event to a Text part in a window, the cursor is moved to this field.
helpFile
A helpFile event indicates that a signal is sent to the part that the help file associated with the part has changed
helpKeysId
A helpKeysId event indicates that the ID of the keys, help has associated with the part, has changed. The ID can be a string or an integer value.
helpRequested
The helpRequested event signals that help has been requested. You can connect the helpRequested event to an action that displays your own help, such as a message box. If the action you connect this event to does not return nil, default help processing occurs, using the specified help file and help topic.
helpTitle
A helpTitle event signals the part that the title of the help window associated with that part has changed
helpTopicId
The helpTopicId event signals a change in the ID of the help topic associated with the part. The ID can be a string or an integer.
innerMargin
An innerMargin event indicates a change in the amount of space, in pixels, to leave between the icon and its label.
itemHeight
An event of itemHeight signals the part that the height to use for each icon and label in the part has changed.
itemMenu
An itemMenu event indicates that the menu part to use an item's pop-up menu has changed. This menu is displayed when the mouse button 2 is clicked on an item in the part.
itemPopUpMenuRequest
The itemPopUpMenuRequest event signals that the pop-up menu for an item in the part has been requested.
If the itemMenu attribute is connected to a Menu part, that menu part is displayed unless you change the itemMenu attribute as a result of this event. You can change the itemMenu attribute to include your own menu or leave it unchanged to use the original setting.
items
An items event signals that the collection of items to display in the part has changed.
itemWidth
An itemWidth event indicates that the width utilized for each icon and label in the part has changed.
labelOrientation
An event of labelOrientation indicates a change in how the icon labels are to be displayed in the part. Possible values are:
XmRIGHT
Specifies that the label is placed to the right of each icon. This is the default.
XmBOTTOM
Specifies that the label is placed below each icon.
losingFocus
The losingFocus event signals that the part is losing focus. If the part does not have focus, keyboard input is not accepted.
mappedWhenManaged
The mappedWhenManaged event signals the part to be visible if the mappedWhenManaged attribute has been set to true.
mappedWidget
The mappedWidget event signals that the part has been shown on the screen.
menu
A menu event signals that a change in which menu part to use, as the parts menu bar or pop-up menu, has occurred.
openedWidget
The openedWidget event signals that the part has been opened and displayed on the screen.
popUpMenuRequest
The popUpMenuRequest event signals that the pop-up menu for the part has been requested.
If the menu attribute is connected to a Menu part, that menu part is displayed unless you change the menu attribute as a result of this event. You can change the menu attribute to include your own menu or leave it unchanged to use the original setting.
refreshEntireListOnChange
A refreshEntireListOnChange event signals the part that a change to one of the part's items has occurred and therefore the list is automatically updated.
refreshItemOnAttributeChange
A refreshItemOnAttributeChange event indicates a change in an attribute of an item, in the model, has signaled an update to the part.
resized
The resized event signals that the part has been sized.
scrollableDown
A scorllableDown event indicates that the container part can currently be scrolled downward.
scrollableLeft
A scrollableLeft event indicates that the container part can currently be scrolled left
scrollableRight
A scrollableRight event indicates that the container part can currently be scrolled right.
scrollableUp
A scrollableUp event indicates that the container part can currently be scrolled up
scrollBarDisplayPolicy
A scrollBarDisplayPolicy event indicates a change in the automatic placement of the scroll bars. Valid values are:
XmASNEEDED
Scroll bars will be displayed only if the list items exceed the container work region either horizontally or vertically.
XmSTATIC
Scroll bars will be displayed regardless of the relationship between the size of the list items and the size of the container.
scrolled
The scrolled event signals that the part has been scrolled.
scrollingWithHiddenScrollBars
A scrollingWithHiddenScrollBars event signals the part to hide its scroll bars. However, scrolling can still be performed.
selectedItem
The selectedItem event signals the part that the item that is currently selected has changed.
selectedItems
A selectedItems event indicates that the selected items have been highlighted (given focus).
selectedItemsChanged
The selectedItemsChanged event signals that the items that are selected have changed.
selectionIndex
The selectionIndex event signals the part that the index for the collection of items of the part has changed.
selectedIndices
A selectedIndices event indicates a change in the indices of the items selected in the part.
selectionIndicesChanged
The selectionIndicesChanged event signals that the indices of the items that are selected have changed.
selectionIsValid
An event of selectionIsValid signals the part that the current valid selection of the part has changed.
selectionPolicy
A selectionPolicy event specifies a change in the selection policy in the container. Possible values, which depend upon the part are as follows:
XmSINGLESELECT
Only one item can be selected at a time.
XmMULTIPLESELECT
Enables multiple selection.
XmEXTENDEDSELECT
Enables extended selection.
XmBROWSESELECT
Enables drag and browse functionality. This is the default value.
XmREADONLYSELECT
Enables navigation, but no selection or callbacks.
showHorizontalScrollBar
A showHorizontalScrollBar event indicates that he part's horizontal scroll bar is displayed so the user can scroll horizontally through the text.
showIcons
A showIcons event signals the part to show its icons.
tabGroup
A tabGroup event signals the part that it is included as a tab stop and can be accessed via the Tab or Backtab keys
traversalOn
The traversalOn property specifies whether users can access the part using the cursor movement keys. If the part is specified as a tab stop by using the tabGroup property, users also can use the Tab and Backtab keys to access the part.
unmappedWidget
The unmappedWidget event signals that the part is about to be hidden.
visualInfoRequested
The visualInfoRequested event signals that the visual information for an item has been requested. This event passes the parameter itemVisualInfo, whose class is EwIconVisualInfoCallbackData. The itemVisualInfo parameter is used to specify the item's visual information, such as the icon and label to display. The itemVisualInfo parameter has the following attributes for specifying the item's visual information:
item (Object)
The item for which the visual information is being requested
itemPosition (Integer)
The index of the item for which the visual information is being requested
isInUse (Boolean)
Specifies whether or not in use emphasis is to be displayed.
icon (CgIcon)
The icon to display for the item
label (String)
The label to display for the item.