Scrolled Window events
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.
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.
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.
clipBackgroundGraphicsDescriptor
The clipBackgroundGraphicsDescriptor event indicates that the graphic that displays in the background of the window is clipped.
closedWidget
The closedWidget event signals that the part has been closed.
configuredWidget
The configuredWidget event signals that the part has been moved or resized.
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.
dragDropSpec
For more information on the dragDropSpec event, refer to ***.
enabled
The enabled event signals that the part is available for selection.
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.
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.
horizontalPageDecremented
The horizontalPageDecremented event signals that the user has scrolled the window to the left by a page by clicking to the left of the scroll box on the horizontal scroll bar.
horizontalPageIncremented
The horizontalPageIncremented event signals that the user has scrolled the window to the right by a page by clicking to the right of the scroll box on the horizontal scroll bar.
horizontalScrollDecremented
The horizontalScrollDecremented event signals that the user has scrolled the window to the left by clicking on the left scroll button on the horizontal scroll bar.
horizontalScrollDragged
The horizontalScrollDragged event signals that the user has scrolled the window to the right or the left by dragging the scroll box on the horizontal scroll bar.
horizontalScrollIncremented
The horizontalScrollIncremented event signals that the user has scrolled the window to the right by clicking on the right scroll button on the horizontal scroll bar.
horizontalScrollValueChanged
The horizontalScrollValueChanged event signals that the value of the horizontal scroll bar changed.
hoverHelpEnabled
A hoverHelpEnabled event signals the part to provide hover help for the part and all of its children.
hoverHelpRemoved
The hoverHelpRemoved event indicates that hover help has been removed from the part or one of its children. You can use this event to signal when to remove hover help information in an information area. This event is only signaled if the part has hoverHelpEnabled set to true.
Note:
When the event is signaled, the UI process may be blocked. Therefore, do not send any messages that get processed by the UI process, such as Transcript show.
This event passes a parameter, whose class is AbtEwIconHoverHelpCallbackData. The parameter has the following attributes for specifying settings for the hover help:
hoverArea (AbtBasicView)
Specifies the hover area that contains the item under the mouse pointer
isHoverHelpShown (Boolean)
Specifies whether or not the hover help is shown
item (AbtBasicView)
Specifies the item under the mouse pointer
labelString (String)
Specifies the hover help string to display, if any. If the item under the pointer is a graphic push button, the default hover help string is the item's labelString attribute. Otherwise, the default value is nil. A value of nil causes no hover help to be displayed.
pointerLocation (Point)
Specifies the location of the mouse pointer relative to the screen.
Note:
For Window parts, this event is signalled even if showHoverHelp of hoverHelpDescriptor is set to false, so that the event can still be used to signal when to remove hover help information from an information area.
hoverHelpRequested
The hoverHelpRequested event indicates that hover help is about to be displayed over the part or one of its children. You can use this event to signal when to display hover help information in an information area. This event is only signaled if the part has hoverHelpEnabled set to true.
Note:
When the event is signaled, the UI process may be blocked. Therefore, do not send any messages that get processed by the UI process, such as Transcript show.
This event passes a parameter, whose class is AbtEwIconHoverHelpCallbackData. The parameter has the following attributes for specifying settings for the hover help:
hoverArea (AbtBasicView)
Specifies the hover area that contains the item under the mouse pointer
isHoverHelpShown (Boolean)
Specifies whether or not the hover help is shown
item (AbtBasicView)
Specifies the item under the mouse pointer
labelString (String)
Specifies the hover help string to display, if any. If the item under the pointer is a graphic push button, the default hover help string is the item's labelString attribute. Otherwise, the default value is nil. A value of nil causes no hover help to be displayed.
pointerLocation (Point)
Specifies the location of the mouse pointer relative to the screen.
Note:
For Window parts, this event is signalled even if showHoverHelp of hoverHelpDescriptor is set to false, so that the event can still be used to signal when to remove hover help information from an information area.
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.
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.
self
A self event indicates that the value of the target part itself has changed.
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.
verticalPageDecremented
The verticalPageDecremented event signals that the user has scrolled the window up a page by clicking above the scroll box on the vertical scroll bar.
verticalPageIncremented
The verticalPageIncremented event signals that the user has scrolled the window down a page by clicking below the scroll box on the vertical scroll bar.
verticalScrollDecremented
The verticalScrollDecremented event signals that the user has scrolled the window up by clicking on the top scroll button on the vertical scroll bar.
verticalScrollDragged
The verticalScrollDragged event signals that the user has scrolled the window up or down by dragging the scroll box on the vertical scroll bar.
verticalScrollIncremented
The verticalScrollIncremented event signals that the user has scrolled the window down by clicking on the bottom scroll button on the vertical scroll bar.
verticalScrollValueChanged
The verticalScrollValueChanged event signals that the value of the vertical scroll bar changed.
visualPolicy
A visualPolicy event indicates the size of the Scrolled Window part has changed. Valid values are:
XmVARIABLE
Specifies that the work area grows or shrinks at any time and will adjust to the parts within it. This is the default value.
XmCONSTANT
Specifies that the work area grows and shrinks as requested, but a clipping area forces the size of the visible portion to remain constant. Only the parent of the Scrolled Window part can cause the clipping area to grow in size.
Note:
To create a cross-platform or portable application, do not depend on the clipping area for certain actions.
workView
An event of workView indicates a change in the view to be displayed inside the scrolled window.
Last modified date: 01/29/2015