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

NAME

XtCallActionProc - invoke an action procedure directly

SYNTAX

void XtCallActionProc(Widget widget, String action, XEvent* event, String* params, Cardinal num_params);

ARGUMENTS

widget

Specifies the widget in which the action is to be invoked. Must be of class core of any subclass thereof.

action

Specifies the name of the action routine.

event

Specifies the contents of the event passed to the action routine.

params

Specifies the contents of the params passed to the action routine.

num_params

Specifies the num of entries in params.

DESCRIPTION

XtCallActionProc searches for the named action routine in the same manner and order as translation tables are bound. If found, the action routine is invoked with the specified widget, event pointer, and parameters. It is the responsibility of the caller to ensure that the contents of event, params, and num_params arguments are appropriate for the specified routine, and if necessary, that the specified widget is realized or sensitive. If the named action routine cannot be found, XtCallActionProc generates a warning message and returns.

SEE ALSO

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