KwikPeg Manuals
Home
Message Types
Index
Index


Overview

KwikPeg uses its built-in message services to send event notification messages directly to the object in your GUI responsible for handling the event.

Signals provide an application dependent mechanism for sending custom messages to your GUI objects.


PM_ADD This message can be issued to add an object to another object. The message pTarget field should contain a pointer to the parent object. The message pSource field must contain a pointer to the child object.
PM_CLOSE This message, recognized by PegWindow derived objects, causes the recipient to remove itself from its parent and delete itself from memory.
PM_CURRENT This message is sent to an object when it becomes a member of the branch of the presentation tree which has input focus.
PM_DESTROY This message is sent to Presentation Manager to destroy an object. The pSource member of the message must point to the object to be destroyed.
PM_DIALOG_NOTIFY This message is sent to the owner of a PegDialog when the dialog window is closed, provided the dialog window is not being executed as a modal dialog. The message iData field will contain the object ID of the button used to close the dialog window.
PM_DRAW This message can be sent to an object to force that object to redraw itself.
PM_EXIT This message is sent to Presentation Manager to force termination of the KwikPeg GUI.
PM_GAINED_KEYBOARD This message is sent to an object when it gains keyboard input focus.
PM_HIDE This message is sent to an object when the object is removed from its visible parent.
PM_KEY This message is sent to the object having the current input focus when keyboard input is received. This message is usually generated by a keyboard driver in response to a key press. The message iData field contains the ASCII character code, if any, for the key which initiated the message. The lData field of the message will contain the current keyboard state information (Shift, Ctrl, Alt, Caps-Lock, Num-Lock, Scroll-Lock), if available.
PM_KEY_RELEASE This message is sent by a keyboard driver to the object having the current input focus whenever a key is released. If the key release cannot be detected, the keyboard driver must follow every PM_KEY message with a PM_KEY_RELEASE message so that all KwikPeg objects will operate correctly. The message iData field contains the ASCII character code, if any, for the key which was released. The lData field of the message will contain the current keyboard state information (Shift, Ctrl, Alt, Caps-Lock, Num-Lock, Scroll-Lock), if available.
PM_LBUTTONDOWN This message is sent to an object when the user presses the left button of a mouse or equivalent pointing device. The position of the mouse click is included in the message Point field. The Presentation Manager routes mouse input directly to the lowest child object enclosing the click coordinates. If the child object does not process mouse input, the message is passed up to the parent object. This process continues until an object in the active tree processes the message. If no object processes the message, the Presentation Manager rejects the message thereby ignoring the mouse click.
PM_LBUTTONUP This message is sent to an object when the user releases the left button of a mouse or equivalent pointing device. The flow for this message is identical to that described for the PM_LBUTTONDOWN message.
PM_LOST_KEYBOARD This message is sent to an object when it loses keyboard input focus.
PM_MAXIMIZE This message can be sent to any PegWindow derived object. If the target window is sizeable, as determined by the window's PSF_SIZEABLE status flag, the window will resize itself to fill the client rectangle of its parent.
PM_MINIMIZE This message can be sent to any PegWindow derived object. If the target window is sizeable, as determined by the window's PSF_SIZEABLE status flag, the window will create a proxy PegIcon, add the icon to the parent window and remove itself from its parent.
PM_MWCOMPLETE This message is sent to the owner of a PegMessageWindow when the message window is closed, provided the message window is not being executed as a modal window. The message iData member will contain the object ID of the button used to close the message window.
PM_NONCURRENT This message is sent to an object when it loses membership in the branch of the presentation tree which has input focus.
PM_PARENTSIZED This message is sent to all children of a PegWindow derived object if the window is resized. Child windows that must maintain a certain proportional spacing or position within their parent window can easily catch this message and resize themselves whenever the size of the parent window is altered.
PM_POINTER_ENTER This message is sent to an object when the mouse pointer or equivalent pointing device first enters the region bounded by an object.
PM_POINTER_EXIT This message is sent to an object when the mouse pointer or equivalent pointing device leaves the region bounded by an object.
PM_POINTER_MOVE This message is sent to an object when the mouse pointer or equivalent pointing device moves within the region bounded by an object.
PM_SHOW This message is sent to an object when the object is added to a visible parent. The message is sent to the object before the object is first drawn, thereby allowing the object to perform any necessary initialization prior to the drawing of the object on the screen.
PM_SIZE This message is sent to an object to command the object to resize or move itself. The new dimensions and location for the object are included in the Rect field of the message. This message has the same effect as a call to the object's Resize() function. Note that KwikPeg does not differentiate between moving an object and resizing an object. Both are accomplished via the Resize() operation.
PM_RESTORE This message can be sent to any PegWindow derived object which can be resized. The message requests the window to restore itself to the size and location that it occupied before being maximized or minimized.
PM_RBUTTONDOWN This message is sent to an object when the user presses the right button of a mouse or equivalent pointing device. The flow for this message is identical to that described for the PM_LBUTTONDOWN message. Note that this message is only used by systems that support right mouse button input. The KwikPeg objects provided with the KwikPeg Library do not process right mouse button messages.
PM_RBUTTONUP This message is sent to an object when the user releases the right button of a mouse or equivalent pointing device. The flow for this message is identical to that described for the PM_RBUTTONDOWN message.
PM_TIMER This message is sent to an object when a timer started by that object expires. The timer ID of the expired timer is provided in the iData member of the message. An object starts a timer with a particular timer ID using the SetTimer() function of the PegMessageQueue.



Top of page
KwikPeg Manuals
Home
Index
Index

 
Copyright © 2000-2003