src/gtkpounce.h

Mon, 12 Dec 2005 18:59:29 +0000

author
Casey Harkins <charkins@pidgin.im>
date
Mon, 12 Dec 2005 18:59:29 +0000
changeset 12468
fe558afb01b4
parent 12155
a7f7e1ecd799
permissions
-rw-r--r--

[gaim-migrate @ 14778]
SF Patch #1372898 from charkins

"This patch updates the unseen conversation api in
gtkconv to ensure consistancy and avoid code
duplication. The ...first_unseen() function is renamed
and expanded to return a list of conversations that
match the specified criteria. A max_count parameter is
used to allow this to short circuit early (using 1
gives old behavior). An additional flag was added to
allow this function to only consider hidden
conversations (used by the buddy list). The blist is
currently inconsistant in which conversations it loops
over for showing the menu tray icon, creating the
tooltip and the unseen menu. This patch fixes that.

The ...find_unseen_list() now handles contact-aware
conversations correctly as well (based on sadrul's
patches in #1362579 which are obsoleted by this patch).

I also included the fix from #1362579 which increments
unseen_count only when state>=UNSEEN_TEXT."

committer: Richard Laager <rlaager@pidgin.im>

/**
 * @file gtkpounce.h GTK+ Buddy Pounce API
 * @ingroup gtkui
 *
 * gaim
 *
 * Gaim is the legal property of its developers, whose names are too numerous
 * to list here.  Please refer to the COPYRIGHT file distributed with this
 * source distribution.
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef _GAIM_GTKPOUNCE_H_
#define _GAIM_GTKPOUNCE_H_

#include "pounce.h"

/**
 * Displays a New Buddy Pounce or Edit Buddy Pounce dialog.
 *
 * @param account    The optional account to use.
 * @param name       The optional name to pounce on.
 * @param cur_pounce The current buddy pounce, if editing an existing one.
 */
void gaim_gtk_pounce_editor_show(GaimAccount *account, const char *name,
								GaimPounce *cur_pounce);

/**
 * Shows the pounces manager window.
 */
void gaim_gtk_pounces_manager_show(void);

/**
 * Hides the pounces manager window.
 */
void gaim_gtk_pounces_manager_hide(void);

/**
 * Returns the gtkpounces handle
 *
 * @return The handle to the GTK+ pounces system
 */
void *gaim_gtk_pounces_get_handle(void);

/**
 * Initializes the GTK+ pounces subsystem.
 */
void gaim_gtk_pounces_init(void);

#endif /* _GAIM_GTKPOUNCE_H_ */

mercurial