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.
allowShellResize
An allowShellResize event signals the window part to change size when the contents of the window changes size.
backgroundColor
The backgroundColor event signals the part that the background color has changed.
backgroundGraphicsDescriptor
The backgroundGraphicsDescriptor event indicates a change in the icon, bitmap, or image that is used for the part's background.
borderWidth
The borderWidth event signals the part that the width of the border, specified in pixels, has changed.
buttonFontName
The buttonFontName event indicates a change in the font used for the buttons in the part.
closedWidget
The closedWidget event signals that the part has been closed.
closeWidgetRequest
The closeWidgetRequest event signals that a request has been made to close the target part.
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.
dialogBorder
The dialogBorder event indicates that the part has a dialog border.
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.
fractionBase
A fractionBase event signals the denominator used in the fraction to calculate the percentage for the proportional spacing has changed. The default value is 100.
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.
horizontalSpacing
A horizontalSpacing event signals a change in horizontal space between the part and its children. The default is 0.
hoverHelpDescriptor
A hoverHelpDescriptor event signals a change in how the hover help box will display graphically.
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.
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.
horizontalSpacing
A horizontalSpacing event signals a change in horizontal space between the part and its children. The default is 0.
hoverHelpDescriptor
A hoverHelpDescriptor event signals a change in how the hover help box will display graphically.
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.
icon
An icon event signals a change in the icon representing the window or the system menu icon.
iconic
An iconic event signals a change in the window's icon state. If you set the iconic attribute to true, then the window appears in its icon state.
initWidgetSize
An initWidgetSize event signals a change in the initial size of the part.
inputMethodEditor
An inputMethodEditor event signals the part that the input method editor (IME), used for input on a double-byte platform, has changed.
inputType
An inputType event signals the part that the type of input in the input method editor (IME), on a double-byte platform, has changed. Valid values are:
•XmSBCSPHONETIC
•XmSBCSALPHANUMERIC
•XmDBCSPHONETIC
•XmDBCSNATIVE
•XmDBCSALPHANUMERIC
labelFontName
A labelFontName event indicates a change in the font used for the labels of the part.
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.
marginHeight
The marginHeight event sends a signal to the part that the amount of vertical space between the part and its children has changed.
marginWidth
A marginWidth event indicates a change in the amount of horizontal space between the part and its children that are not attached.
maximizeButton
A maximizeButton event signals there is a maximize button available for selection.
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.
minimizeButton
A minimizeButton event signals there is a minimize button available for selection.
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.
resized
The resized event signals that the part has been sized.
resizePolicy
A resizePolicy event signals a change in how the part is to be sized as children are added, removed, and otherwise manipulated in the part.
resurfaced
The resurfaced event signals that the Window has been brought in front of the other windows.
rubberPositioning
A rubberPositioning event indicates that a change in whether child parts have their positions converted to proportional attachments has occurred. If rubberPositioning is set to true, all children parts with no attachments on their top, bottom, left, or right, have their initial top and left positions converted to proportional attachments. If rubberPositioning is set to false, then the initial top and left positions are attached to the parent.
self
A self event indicates that the value of the target part itself has changed.
shellDecorations
A shellDecorations event signals a change in the decorations currently set on the shell. The resulting integer is the bitwise-OR of the values. This value determines whether to include a border, resize frame handles, title bar, window close/system menu, minimize button, or maximize button.
sizeBorder
A sizeBorder event indicates that the part has a border that can be changed.
systemMenu
A systemMenu event indicates that the part has a system menu.
textFontName
A textFontName event indicates a change in the text used for the child text parts of the part.
title
A title event signals that the label displayed for the part has changed.
titleBar
A titleBar event signals that the part has a title bar.
unmappedWidget
The unmappedWidget event signals that the part is about to be hidden.
verticalSpacing
A verticalSpacing event indicates the amount of vertical space between the part and it's children has changed.
wallpaperStyle
An event of wallpaperStyle indicates a change in how the wallpaper images are displayed. Possible values are:
•XmNORMAL
•XmTILED
•XmSCALED