[Previous] [Contents] [Index] [Next]

PhWindowEvent_t

Data structure describing a window action

Synopsis:

typedef struct _Ph_window_event {
    ulong_t             event_f;
    ulong_t             state_f;
    PhRid_t             rid;
    PhPoint_t           pos;
    PhDim_t             size;
    ushort_t            event_state;
    ushort_t            input_group;
    ulong_t             rsvd[4];
} PhWindowEvent_t;

Description:

Using the PhWindowEvent_t structure, your application can determine what kind of window action just occurred, or can tell the window manager to perform a specific action on its behalf.

This structure contains at least the following members:

unsigned long event_f
The type of the window event. The flags you can set in this member are the same as those for Pt_ARG_WINDOW_MANAGED_FLAGS and Pt_ARG_WINDOW_NOTIFY_FLAGS resources of the PtWindow widget (described in the Photon Widget Reference):

Some events can have two meanings; see the description of the event_state member.

unsigned long state_f
The current state of the window:
PhRid_t rid
The ID of the affected region.
short event_state
Indicates that the Window Manager has completed or been asked to complete the requested action. If the event is emitted to the Window Manager, the event is performed by the Window Manager. If an application collects the event, the Window Manager has completed the event.

The following operations have two event states; you can OR one of these states into event_state:

PhPoint_t pos
The position of the window. This member is valid only for Ph_WM_BACKDROP, Ph_WM_MAX, Ph_WM_MOVE, Ph_WM_RESIZE, and Ph_WM_RESTORE events.
PhDim_t size
Indicates the width and height of the window. This member is only for Ph_WM_BACKDROP, Ph_WM_MAX, Ph_WM_RESIZE, and Ph_WM_RESTORE events.
ushort_t input_group
The input group associated with the event.

Classification:

Photon

See also:

PtForwardWindowEvent(), PtForwardWindowTaskEvent()

Window Management chapter of the Photon Programmer's Guide.


[Previous] [Contents] [Index] [Next]