Class UIWinEvent

public class UIWinEvent
{
  // Fields
  public static final int EVENT_OBJECT_ACCELERATORCHANGE;
  public static final int EVENT_OBJECT_CREATE;
  public static final int EVENT_OBJECT_DEFACTIONCHANGE;
  public static final int EVENT_OBJECT_DESCRIPTIONCHANGE;
  public static final int EVENT_OBJECT_DESTROY;
  public static final int EVENT_OBJECT_FOCUS;
  public static final int EVENT_OBJECT_HELPCHANGE;
  public static final int EVENT_OBJECT_HIDE;
  public static final int EVENT_OBJECT_LOCATIONCHANGE;
  public static final int EVENT_OBJECT_NAMECHANGE;
  public static final int EVENT_OBJECT_PARENTCHANGE;
  public static final int EVENT_OBJECT_REORDER;
  public static final int EVENT_OBJECT_SELECTION;
  public static final int EVENT_OBJECT_SELECTIONADD;
  public static final int EVENT_OBJECT_SELECTIONREMOVE;
  public static final int EVENT_OBJECT_SELECTIONWITHIN;
  public static final int EVENT_OBJECT_SHOW;
  public static final int EVENT_OBJECT_STATECHANGE;
  public static final int EVENT_OBJECT_VALUECHANGE;
  public static final int EVENT_SYSTEM_ALERT;
  public static final int EVENT_SYSTEM_CAPTUREEND;
  public static final int EVENT_SYSTEM_CAPTURESTART;
  public static final int EVENT_SYSTEM_CONTEXTHELPEND;
  public static final int EVENT_SYSTEM_CONTEXTHELPSTART;
  public static final int EVENT_SYSTEM_DIALOGEND;
  public static final int EVENT_SYSTEM_DIALOGSTART;
  public static final int EVENT_SYSTEM_DRAGDROPEND;
  public static final int EVENT_SYSTEM_DRAGDROPSTART;
  public static final int EVENT_SYSTEM_FOREGROUND;
  public static final int EVENT_SYSTEM_MENUEND;
  public static final int EVENT_SYSTEM_MENUPOPUPEND;
  public static final int EVENT_SYSTEM_MENUPOPUPSTART;
  public static final int EVENT_SYSTEM_MENUSTART;
  public static final int EVENT_SYSTEM_MINIMIZEEND;
  public static final int EVENT_SYSTEM_MINIMIZESTART;
  public static final int EVENT_SYSTEM_MOVESIZEEND;
  public static final int EVENT_SYSTEM_MOVESIZESTART;
  public static final int EVENT_SYSTEM_SCROLLINGEND;
  public static final int EVENT_SYSTEM_SCROLLINGSTART;
  public static final int EVENT_SYSTEM_SOUND;
  public static final int EVENT_SYSTEM_SWITCHEND;
  public static final int EVENT_SYSTEM_SWITCHSTART;
  public static final int OBJID_WINDOW;

  // Methods
  public static Object getObject(int id);
  public static void notify(int event, Object obj);
}

This class implements a window event notification method. This method allows any object to track the events occurring in any child or parent container. The list of constants represent events that may be used to track the changes in the state of an object. This list of constants may be extended to include additional events that may need to be tracked.

Methods

getObject

public static Object getObject(int id);

This method retrieves an object based on the ID.

Return Value:

Returns The object that is identified by the value of the ID.

Parameter	Description
id	The id of the object to find.

notify

public static void notify(int event, Object obj);

Notifies the object when an event occurs. For example, notification could be sent to the parent when a child component changed its location.

Return Value:

No return value.

Parameter	Description
event	The event to send.
obj	The object to be notified.

Fields

EVENT_OBJECT_ACCELERATORCHANGE

This event is sent when the keyboard accelerator has changed.

EVENT_OBJECT_CREATE

This event is sent when a visible object is created.

EVENT_OBJECT_DEFACTIONCHANGE

This event is sent when the default action has changed.

EVENT_OBJECT_DESCRIPTIONCHANGE

This event is sent when the object's description has changed.

EVENT_OBJECT_DESTROY

This event is sent when a visible object is destroyed.

EVENT_OBJECT_FOCUS

This event is sent when the object is receiving focus.

EVENT_OBJECT_HELPCHANGE

This event is sent when the object's Help has changed.

EVENT_OBJECT_HIDE

This event is sent when a visible object is hidden.

EVENT_OBJECT_LOCATIONCHANGE

This event is sent when the object's locatin (move/size) has changed.

EVENT_OBJECT_NAMECHANGE

This event is sent when the object's name has changed.

EVENT_OBJECT_PARENTCHANGE

This event is sent when the object's parent has changed.

EVENT_OBJECT_REORDER

This event is sent when the order of the objects has changed.

EVENT_OBJECT_SELECTION

This event is sent when the item with the selection is moving to a different item within a container.

EVENT_OBJECT_SELECTIONADD

This event is sent when a new item has been added to the selection with a container. Use this event when the number of newly selected items is very small.

EVENT_OBJECT_SELECTIONREMOVE

This event is sent when a new item has been removed from the selection within a container. Use this event when the number of newly selected items is very small.

EVENT_OBJECT_SELECTIONWITHIN

This event is sent when the selected items within a control have changed substantially. Rather than propagate a large number of events to reflect a multitude of changes, the SELECTIONWITHIN event is sent. The user should query the container control for more detailed information about which events have occurred.

EVENT_OBJECT_SHOW

This event is sent when a visual object is shown.

EVENT_OBJECT_STATECHANGE

This event is sent when the object's state has changed.

EVENT_OBJECT_VALUECHANGE

This event is sent when the object's value has changed.

EVENT_SYSTEM_ALERT

This event is sent when an alert needs to be given to the user. For example, alerts are generated in UIMessageBox.

EVENT_SYSTEM_CAPTUREEND

This event is sent when a window releases the capture.

EVENT_SYSTEM_CAPTURESTART

This event is sent when a window takes the capture.

EVENT_SYSTEM_CONTEXTHELPEND

This event is sent when a window leaves context sensitive help mode.

EVENT_SYSTEM_CONTEXTHELPSTART

This event is sent when a window enters context-sensitive help mode.

EVENT_SYSTEM_DIALOGEND

This event is sent just before the dialog disappears.

EVENT_SYSTEM_DIALOGSTART

This event is sent when a dialog appears.

EVENT_SYSTEM_DRAGDROPEND

This event is sent when a window leaves drag-drop mode.

EVENT_SYSTEM_DRAGDROPSTART

This event is sent when a window enters drag-drop mode.

EVENT_SYSTEM_FOREGROUND

This event is sent when the foreground (active) window changes, even if it is changing to another window in the same thread as the previous one.

EVENT_SYSTEM_MENUEND

This event is sent when leaving menu mode.

EVENT_SYSTEM_MENUPOPUPEND

This event is sent right before a menu pop-up disappears.

EVENT_SYSTEM_MENUPOPUPSTART

This event is sent when a menu pop-up appears.

EVENT_SYSTEM_MENUSTART

This event is sent when entering into menu mode.

EVENT_SYSTEM_MINIMIZEEND

This event is sent just before the window is restored from minimize mode.

EVENT_SYSTEM_MINIMIZESTART

This event is sent when a window is minimized.

EVENT_SYSTEM_MOVESIZEEND

This event is sent when a window leaves move-size dragging mode.

EVENT_SYSTEM_MOVESIZESTART

This event is sent when a window enters move-size dragging mode.

EVENT_SYSTEM_SCROLLINGEND

This event is sent when the tracking of a scroll bar ends.

EVENT_SYSTEM_SCROLLINGSTART

This event is sent when the tracking of a scroll bar begins.

EVENT_SYSTEM_SOUND

This event is sent when a sound is played.

EVENT_SYSTEM_SWITCHEND

This event is sent when ending the ALT-TAB mode to switch windows.

EVENT_SYSTEM_SWITCHSTART

This event is sent when entering the ALT-TAB mode to switch windows.

OBJID_WINDOW

This is the standard ID value for a window.