view doc/sound-signals.dox @ 28975:bd4f23c22dc2

Prevent an infinite loop from the preference window. If the preference window doesn't get the window-size it requested, it goes into an infinite loop. This is caused by the imhtml widget in the conversations page, and happens when the window-manager gives it a really small size such that the imhtml widget doesn't get displayed. So, instead of making the widget change its size, keep it in a fixed size. The width of the preference pages are now dictated mostly by the network, status and themes pages. So extending the fixed width of the imhtml widget in the conversation page should not cause too many problems.

/** @page sound-signals Sound Signals

 @signals
  @signal playing-sound-event
 @endsignals

 @see sound.h

 <hr>

 @signaldef playing-sound-event
  @signalproto
gboolean (*playing_sound_event)(PurpleSoundEventID event, PurpleAccount *account);
  @endsignalproto
  @signaldesc
   Emitted when libpurple is going to play a sound event. This can be used to cancel playing sound by returning TRUE.
  @param event   The event this sound represents.
  @param account The account the sound is being played for.
  @return @c TRUE if the sound should not be played, or @c FALSE otherwise.
 @endsignaldef

 */
// vim: syntax=c.doxygen tw=75 et