XtAppAddBlockHook (3)

Leading comments

Copyright (c) 1993, 1994  X Consortium

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software furnished to do so, subject to the following conditions:

The above copyright notice...

(The comments found at the beginning of the groff file "man3/XtAppAddBlockHook.3".)

NAME

XtAppAddBlockHook, XtRemoveBlockHook - register a block hook procedure

SYNTAX

XtBlockHookId XtAppAddBlockHook(XtAppContext app_context, XtBlockHookProc proc, XtPointer client_data);

void XtRemoveBlockHook(XtBlockHookId id);

ARGUMENTS

app_context

Specifies the application context.

proc

Specifies the block hook procedure.

num_args

Specifies the application-specific data to be passed to the block hook.

DESCRIPTION

XtAppAddBlockHook registers the specified procedure and returns an identifier for it. The hook is called at any time in the future when the Intrinsics are about to block pending some input.

Block hook procedures are removed automatically and the XtBlockHookId is destroyed when the application context in which they were added is destroyed.

XtRemoveBlockHook removes the specified block hook procedure from the list in which it was registered.

SEE ALSO

X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface