VSelectEvents
Name
VSelectEvents - selects the event types for 3DVIEWNIX windows.
Synopsis
VSelectEvents(win, event_mask)
Window win;
unsigned long event_mask;
Description
VSelectEvents selects the event types to be sent to a specified window
in 3DVIEWNIX. If the window ID is not valid, VSelectEvents returns 6.
The bits of the event mask are defined in and they are listed
below:
ButtonPressMask NoEventMask
ButtonReleaseMask KeyPressMask
EnterWindowMask KeyReleaseMask
LeaveWindowMask ExposureMask
PointerMotionMask VisibilityChangeMask
PointerMotionHintMask StructureNotifyMask
Button1MotionMask ResizeRedirectMask
Button2MotionMask SubstructureNotifyMask
Button3MotionMask SubstructureRedirectMask
Button4MotionMask FocusChangeMask
Button5MotionMask PropertyChangeMask
ButtonMotionMask ColormapChangeMask
KeymapStateMask OwnerGrabButtonMask
A call on get_event overrides any previous call on get_event for the same
window from the same client but not for other clients. Multiple clients
can select input on the same window if the event_mask passed are disjoint.
When an event is generated it will be reported to all interested clients.
However only one client at a time can select for each of
SubstructureRedirectMask, ResizeRedirectMask, and ButtonPressMask. If a
client attempts to select on one of the three event_masks and some other
client has already selected it on the same window, the X server generates a
BadAccess error.
Return Value
0 - work successfully.
3 - write error.
4 - file open error.
Parameters
win - specifies the ID of the window interested in the input events.
event_mask - specifies the event mask. This mask is the bitwise OR of one
or more of the valid event mask bits.
Side Effects
If the window ID is invalid, VSelectEvents returns 6.
Entry Conditions
VCreateWindows must be called first.
Related Functions
VCancelEvents.