XtAppAddActionHook (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/XtAppAddActionHook.3".)

NAME

XtAppAddActionHook, XtRemoveActionHook - register an action hook procedure

SYNTAX

XtActionHookId XtAppAddActionHook(XtAppContext app_context, XtActionHookProc proc, XtPointer client_data);

void XtRemoveActionHook(XtActionHookId id);

ARGUMENTS

app_context

Specifies the application context.

proc

Specifies the action hook procedure.

num_args

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

DESCRIPTION

XtAppAddActionHook adds the specified procedure to the front of a list maintained in the application context. In the future, when an action routine is about to be invoked for any widget in this application context, either through the translation manager or via XtCallActionProc, the action hohok procedures will be called in reverse order of registration jut prior to invoking the action routine.

Action hook procedures are removed automatically and the XtActionHookId s destroyed when the application context in which they were added is destroyed.

XtRemoveActionHook removes the specified action hook procedure from the list in which it was registered.

SEE ALSO

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