.\" Automatically generated by Pandoc 2.2.1
.\"
.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[]
.fi
.SH DESCRIPTION
.PP
The specified callback function will intercept the window'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[C]result\f[] to customize what Allegro will
return return in response to this event.
By default, Allegro returns \f[C]TRUE\f[].
.PP
The \f[C]userdata\f[] 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