<?xml version='1.0' encoding="ISO-8859-1"?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <chapter id="chapter-signals-notify"> <title>Notify
signals
</title> <refsect1 id="notify.signals" role="signal_proto"> <title role="signal_proto.title">List
of
signals
</title> "<link linkend="notify-displaying-userinfo">displaying-userinfo
</link>" "<link linkend="notify-displaying-email-notification">displaying-email-notification
</link>" "<link linkend="notify-displaying-emails-notification">displaying-emails-notification
</link>" <refsect1 id="notify.signal-details" role="signals"> <title role="signals.title">Signal
details
</title> <refsect2 id="notify-displaying-userinfo" role="signal"> <title>The
<literal>"displaying-userinfo
"</literal> signal
</title> void
user_function
(PurpleAccount
*account,
PurpleNotifyUserInfo
*user_info,
Emitted
before
userinfo
is
handed
to
the
UI
to
display.
<literal>user_info
</literal> can
be
manipulated
via
the
PurpleNotifyUserInfo
API
in
notify.c.
If
adding
a
PurpleNotifyUserInfoEntry,
be
sure
not
to
free
it
--
PurpleNotifyUserInfo
assumes
responsibility
for
its
objects.
<variablelist role="params"> <term><parameter>account
</parameter> :
</term> <listitem><simpara>The
account
on
which
the
info
was
obtained.
</simpara></listitem> <term><parameter>who
</parameter> :
</term> <listitem><simpara>The
name
of
the
buddy
whose
info
is
to
be
displayed.
</simpara></listitem> <term><parameter>user_info
</parameter> :
</term> <listitem><simpara>The
information
to
be
displayed,
as
PurpleNotifyUserInfoEntry
objects.
</simpara></listitem> <term><parameter>user_data
</parameter> :
</term> <listitem><simpara>user
data
set
when
the
signal
handler
was
connected.
</simpara></listitem> <refsect2 id="notify-displaying-email-notification" role="signal"> <title>The
<literal>"displaying-email-notification
"</literal> signal
</title> void
user_function
(const
char
*subject,
Emitted
before
notification
of
a
single
email
is
handed
to
the
UI
to
display.
<variablelist role="params"> <term><parameter>subject
</parameter> :
</term> <listitem><simpara>Subject
of
email
being
notified
of.
</simpara></listitem> <term><parameter>from
</parameter> :
</term> <listitem><simpara>Who
the
email
is
from.
</simpara></listitem> <term><parameter>to
</parameter> :
</term> <listitem><simpara>Who
the
email
is
to.
</simpara></listitem> <term><parameter>url
</parameter> :
</term> <listitem><simpara>A
url
to
view
the
email.
</simpara></listitem> <term><parameter>user_data
</parameter> :
</term> <listitem><simpara>user
data
set
when
the
signal
handler
was
connected.
</simpara></listitem> <refsect2 id="notify-displaying-emails-notification" role="signal"> <title>The
<literal>"displaying-emails-notification
"</literal> signal
</title> void
user_function
(const
char
**subjects,
Emitted
before
notification
of
multiple
emails
is
handed
to
the
UI
to
display.
<variablelist role="params"> <term><parameter>subjects
</parameter> :
</term> <listitem><simpara>Subjects
of
emails
being
notified
of.
</simpara></listitem> <term><parameter>froms
</parameter> :
</term> <listitem><simpara>Who
the
emails
are
from.
</simpara></listitem> <term><parameter>tos
</parameter> :
</term> <listitem><simpara>Who
the
emails
are
to.
</simpara></listitem> <term><parameter>urls
</parameter> :
</term> <listitem><simpara>The
urls
to
view
the
emails.
</simpara></listitem> <term><parameter>count
</parameter> :
</term> <listitem><simpara>Number
of
emails
being
notified
of.
</simpara></listitem> <term><parameter>user_data
</parameter> :
</term> <listitem><simpara>user
data
set
when
the
signal
handler
was
connected.
</simpara></listitem>