.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_win_add_window_callback" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_win_add_window_callback - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro_windows.h>

bool al_win_add_window_callback(ALLEGRO_DISPLAY *display,
   bool (*callback)(ALLEGRO_DISPLAY *display, UINT message, WPARAM wparam,
   LPARAM lparam, LRESULT *result, void *userdata), void *userdata)
\f[R]
.fi
.SH DESCRIPTION
.PP
The specified callback function will intercept the window\[cq]s message
before Allegro processes it.
If the callback function consumes the event, then it should return true.
In that case, Allegro will not do anything with the event.
.PP
Optionally, you may use \f[V]result\f[R] to customize what Allegro will
return return in response to this event.
By default, Allegro returns \f[V]TRUE\f[R].
.PP
The \f[V]userdata\f[R] pointer can be used to supply additional context
to the callback function.
.PP
The callbacks are executed in the same order they were added.
.PP
Returns true if the callback was added.
.SH SINCE
.PP
5.1.2