Mercurial > pidgin.yaz
view src/gtkconv.h @ 10203:7ff9b8b22e7d
[gaim-migrate @ 11324]
gaim_mkstemp can now create binary files
committer: Tailor Script <tailor@pidgin.im>
author | Herman Bloggs <hermanator12002@yahoo.com> |
---|---|
date | Thu, 18 Nov 2004 17:05:40 +0000 |
parents | 53410b84336f |
children | 393750603513 |
line wrap: on
line source
/** * @file gtkconv.h GTK+ Conversation 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_GTKCONVERSATION_H_ #define _GAIM_GTKCONVERSATION_H_ typedef struct _GaimGtkWindow GaimGtkWindow; typedef struct _GaimGtkImPane GaimGtkImPane; typedef struct _GaimGtkChatPane GaimGtkChatPane; typedef struct _GaimGtkConversation GaimGtkConversation; enum { CHAT_USERS_ICON_COLUMN, CHAT_USERS_NAME_COLUMN, CHAT_USERS_FLAGS_COLUMN, CHAT_USERS_COLUMNS }; #define GAIM_GTK_WINDOW(win) \ ((GaimGtkWindow *)(win)->ui_data) #define GAIM_GTK_CONVERSATION(conv) \ ((GaimGtkConversation *)(conv)->ui_data) #define GAIM_IS_GTK_WINDOW(win) \ (gaim_conv_window_get_ui_ops(win) == gaim_gtk_conversations_get_win_ui_ops()) #define GAIM_IS_GTK_CONVERSATION(conv) \ (gaim_conversation_get_ui_ops(conv) == \ gaim_gtk_conversations_get_conv_ui_ops()) #include "gtkgaim.h" #include "conversation.h" /************************************************************************** * @name Structures **************************************************************************/ /*@{*/ /** * A GTK+ representation of a graphical window containing one or more * conversations. */ struct _GaimGtkWindow { GtkWidget *window; /**< The window. */ GtkWidget *notebook; /**< The notebook of conversations. */ struct { GtkWidget *menubar; GtkWidget *view_log; GtkWidget *send_file; GtkWidget *add_pounce; GtkWidget *get_info; GtkWidget *warn; GtkWidget *invite; GtkWidget *alias; GtkWidget *block; GtkWidget *add; GtkWidget *remove; GtkWidget *insert_link; GtkWidget *insert_image; GtkWidget *logging; GtkWidget *sounds; GtkWidget *show_formatting_toolbar; GtkWidget *show_timestamps; GtkWidget *send_as; GtkWidget *typing_icon; GtkItemFactory *item_factory; } menu; /* Tab dragging stuff. */ gboolean in_drag; gboolean in_predrag; gint drag_min_x, drag_max_x, drag_min_y, drag_max_y; gint drag_motion_signal; gint drag_leave_signal; }; /** * A GTK+ Instant Message pane. */ struct _GaimGtkImPane { GtkWidget *block; GtkWidget *send_file; GtkWidget *sep1; GtkWidget *sep2; GtkWidget *check; GtkWidget *progress; gboolean a_virgin; /* Buddy icon stuff */ GtkWidget *icon_container; GtkWidget *icon; gboolean show_icon; gboolean animate; GdkPixbufAnimation *anim; GdkPixbufAnimationIter *iter; guint32 icon_timer; }; /** * GTK+ Chat panes. */ struct _GaimGtkChatPane { GtkWidget *count; GtkWidget *list; GtkWidget *invite; GtkWidget *topic_text; GtkWidget *sep; }; /** * A GTK+ conversation pane. */ struct _GaimGtkConversation { gboolean make_sound; gboolean show_formatting_toolbar; gboolean show_timestamps; GtkTooltips *tooltips; GtkWidget *tab_cont; GtkWidget *tabby; GtkWidget *menu_tabby; GtkWidget *imhtml; GtkTextBuffer *entry_buffer; GtkWidget *entry; GtkWidget *add; GtkWidget *remove; GtkWidget *info; GtkWidget *send; GtkWidget *close; /* "x" on the tab */ GtkWidget *icon; GtkWidget *tab_label; GtkWidget *menu_icon; GtkWidget *menu_label; GtkSizeGroup *sg; GtkWidget *bbox; GtkWidget *lower_hbox; GtkWidget *toolbar; struct { GtkWidget *image; GtkWidget *search; } dialogs; union { GaimGtkImPane *im; GaimGtkChatPane *chat; } u; }; /*@}*/ /************************************************************************** * @name GTK+ Conversation API **************************************************************************/ /*@{*/ /** * Returns the UI operations structure for GTK windows. * * @return The GTK window operations structure. */ GaimConvWindowUiOps *gaim_gtk_conversations_get_win_ui_ops(void); /** * Returns the UI operations structure for GTK conversations. * * @return The GTK conversation operations structure. */ GaimConversationUiOps *gaim_gtk_conversations_get_conv_ui_ops(void); /** * Updates the buddy icon on a conversation. * * @param conv The conversation. */ void gaim_gtkconv_update_buddy_icon(GaimConversation *conv); /** * Updates the tab positions on all conversation windows to reflect any * changed preferences. */ void gaim_gtkconv_update_tabs(void); /** * Updates the button style on chat windows to reflect any * changed preferences. */ void gaim_gtkconv_update_chat_button_style(); /** * Updates the button style on IM windows to reflect any * changed preferences. */ void gaim_gtkconv_update_im_button_style(); /** * Updates conversation buttons by protocol. * * @param conv The conversation. */ void gaim_gtkconv_update_buttons_by_protocol(GaimConversation *conv); /** * Creates a conversation button * * @param icon The stock icon name. * @param text The text for the button. * @param tooltip The tooltip text. * @param tooltips The group of tooltips. * @param callback A function to call when the button is clicked. * @param data Data to pass to the callback. * * @return The button */ GtkWidget *gaim_gtkconv_button_new(const char *icon, const char *text, const char *tooltip, GtkTooltips *tooltips, void *callback, void *data); /** * Returns the window at the specified X, Y location. * * If the window is not a GTK+ window, @c NULL is returned. * * @param x The X coordinate. * @param y The Y coordinate. * * @return The GTK+ window at the location, if it exists, or @c NULL otherwise. */ GaimConvWindow *gaim_gtkwin_get_at_xy(int x, int y); /** * Returns the index of the tab at the specified X, Y location in a notebook. * * @param win The GTK+ window containing the notebook. * @param x The X coordinate. * @param y The Y coordinate. * * @return The index of the tab at the location. */ int gaim_gtkconv_get_tab_at_xy(GaimConvWindow *win, int x, int y); /** * Returns the index of the destination tab at the * specified X, Y location in a notebook. * * This is used for drag-and-drop functions when the tab at the index * is a destination tab. * * @param win The GTK+ window containing the notebook. * @param x The X coordinate. * @param y The Y coordinate. * * @return The index of the tab at the location. */ int gaim_gtkconv_get_dest_tab_at_xy(GaimConvWindow *win, int x, int y); /*@}*/ /**************************************************************************/ /** @name GTK+ Conversations Subsystem */ /**************************************************************************/ /*@{*/ /** * Returns the gtk conversations subsystem handle. * * @return The conversations subsystem handle. */ void *gaim_gtk_conversations_get_handle(void); /** * Initializes the GTK+ conversations subsystem. */ void gaim_gtk_conversations_init(void); /** * Uninitialized the GTK+ conversation subsystem. */ void gaim_gtk_conversations_uninit(void); /*@}*/ #endif /* _GAIM_GTKCONVERSATION_H_ */