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

NAME

XtCallCallbacks, XtCallCallbackList, XtHasCallbacks - process callbacks

SYNTAX

void XtCallCallbacks(Widget w, String callback_name, XtPointer call_data);

void XtCallCallbackList(Widget w, XtCallbackList callbacks, XtPointer call_data);

typedef enum {XtCallbackNoList, XtCallbackHasNone, XtCallbackHasSome} XtCallbackStatus;

XtCallbackStatus XtHasCallbacks(Widget w, String callback_name);

ARGUMENTS

callback_name

Specifies the callback list to be executed or checked.

call_data

Specifies a callback-list specific data value to pass to each of the callback procedure in the list.

callbacks

Specifies the callback list to be executed.

w

Specifies the widget.

DESCRIPTION

The XtCallCallbacks function calls each procedure that is registered in the specified widget's callback list.

If callbacks is not NULL, XtCallCallbackList calls each of the callback procedures in the list, passing client data and call_data. The callbacks parameter must specify the contents of a widget or object resource declared with representation type XtRCallback.

The XtHasCallbacks function first checks to see if the widget has a callback list identified by callback_name. If the callback list does not exist, XtHasCallbacks returns XtCallbackNoList. If the callback list exists but is empty, it returns XtCallbackHasNone. If the callback list exists and has at least one callback registered, it returns XtCallbackHasSome.

SEE ALSO

XtAddCallback(3)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface