pidgin/gtkutils.h

changeset 20940
925d3d68b3af
parent 20147
66f05a854eee
child 21304
ccd8db75dbc2
equal deleted inserted replaced
20939:13dd02add7c1 20940:925d3d68b3af
374 /** 374 /**
375 * Get information about a user. Show immediate feedback. 375 * Get information about a user. Show immediate feedback.
376 * 376 *
377 * @param conn The connection to get information from. 377 * @param conn The connection to get information from.
378 * @param name The user to get information about. 378 * @param name The user to get information about.
379 *
380 * @since 2.1.0
379 */ 381 */
380 void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name); 382 void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name);
381 383
382 /** 384 /**
383 * Get information about a user in a chat. Show immediate feedback. 385 * Get information about a user in a chat. Show immediate feedback.
384 * 386 *
385 * @param conn The connection to get information from. 387 * @param conn The connection to get information from.
386 * @param name The user to get information about. 388 * @param name The user to get information about.
387 * @param chatid The chat id. 389 * @param chatid The chat id.
390 *
391 * @since 2.1.0
388 */ 392 */
389 void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid); 393 void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid);
390 394
391 /** 395 /**
392 * Parses an application/x-im-contact MIME message and returns the 396 * Parses an application/x-im-contact MIME message and returns the
421 /** 425 /**
422 * Sets the labelled-by and label-for ATK relationships. 426 * Sets the labelled-by and label-for ATK relationships.
423 * 427 *
424 * @param w The widget that we want to label. 428 * @param w The widget that we want to label.
425 * @param l A GtkLabel that we want to use as the label for the widget. 429 * @param l A GtkLabel that we want to use as the label for the widget.
430 *
431 * @since 2.2.0
426 */ 432 */
427 void pidgin_set_accessible_relations(GtkWidget *w, GtkWidget *l); 433 void pidgin_set_accessible_relations(GtkWidget *w, GtkWidget *l);
428 434
429 /** 435 /**
430 * A helper function for GtkMenuPositionFuncs. This ensures the menu will 436 * A helper function for GtkMenuPositionFuncs. This ensures the menu will
435 * where the menu shall be drawn. This is an output parameter. 441 * where the menu shall be drawn. This is an output parameter.
436 * @param y Address of the gint representing the vertical position 442 * @param y Address of the gint representing the vertical position
437 * where the menu shall be drawn. This is an output parameter. 443 * where the menu shall be drawn. This is an output parameter.
438 * @param push_in This is an output parameter? 444 * @param push_in This is an output parameter?
439 * @param data Not used by this particular position function. 445 * @param data Not used by this particular position function.
446 *
447 * @since 2.1.0
440 */ 448 */
441 void pidgin_menu_position_func_helper(GtkMenu *menu, gint *x, gint *y, 449 void pidgin_menu_position_func_helper(GtkMenu *menu, gint *x, gint *y,
442 gboolean *push_in, gpointer data); 450 gboolean *push_in, gpointer data);
443 451
444 /** 452 /**
669 * @param default_item Initial contents of GtkEntry 677 * @param default_item Initial contents of GtkEntry
670 * @param items GList containing strings to add to GtkComboBox 678 * @param items GList containing strings to add to GtkComboBox
671 * 679 *
672 * @return A newly created text GtkComboBox containing a GtkEntry 680 * @return A newly created text GtkComboBox containing a GtkEntry
673 * child. 681 * child.
682 *
683 * @since 2.2.0
674 */ 684 */
675 GtkWidget *pidgin_text_combo_box_entry_new(const char *default_item, GList *items); 685 GtkWidget *pidgin_text_combo_box_entry_new(const char *default_item, GList *items);
676 686
677 /** 687 /**
678 * Retrieve the text from the entry of the simple text GtkComboBoxEntry equivalent 688 * Retrieve the text from the entry of the simple text GtkComboBoxEntry equivalent
679 * 689 *
680 * @param widget The simple text GtkComboBoxEntry equivalent widget 690 * @param widget The simple text GtkComboBoxEntry equivalent widget
681 * 691 *
682 * @return The text in the widget's entry. It must not be freed 692 * @return The text in the widget's entry. It must not be freed
693 *
694 * @since 2.2.0
683 */ 695 */
684 const char *pidgin_text_combo_box_entry_get_text(GtkWidget *widget); 696 const char *pidgin_text_combo_box_entry_get_text(GtkWidget *widget);
685 697
686 /** 698 /**
687 * Set the text in the entry of the simple text GtkComboBoxEntry equivalent 699 * Set the text in the entry of the simple text GtkComboBoxEntry equivalent
688 * 700 *
689 * @param widget The simple text GtkComboBoxEntry equivalent widget 701 * @param widget The simple text GtkComboBoxEntry equivalent widget
690 * @param text The text to set 702 * @param text The text to set
703 *
704 * @since 2.2.0
691 */ 705 */
692 void pidgin_text_combo_box_entry_set_text(GtkWidget *widget, const char *text); 706 void pidgin_text_combo_box_entry_set_text(GtkWidget *widget, const char *text);
693 707
694 #endif /* _PIDGINUTILS_H_ */ 708 #endif /* _PIDGINUTILS_H_ */
695 709

mercurial