comparison libpurple/sound-theme.h @ 29681:4548c114e953

propagate from branch 'im.pidgin.pidgin' (head 371b6104658ad98c418ac711643192c2e34428ea) to branch 'im.pidgin.cpw.attention_ui' (head 2b6154716621ea07b8e3ea452bace17539e83494)
author Marcus Lundblad <ml@update.uu.se>
date Sun, 26 Apr 2009 20:01:17 +0000
parents b1c8ffbd48f9
children 4d92a431d0a1
comparison
equal deleted inserted replaced
29680:ce876e58cf6a 29681:4548c114e953
71 GType purple_sound_theme_get_type(void); 71 GType purple_sound_theme_get_type(void);
72 72
73 /** 73 /**
74 * Returns a copy of the filename for the sound event. 74 * Returns a copy of the filename for the sound event.
75 * 75 *
76 * @param theme The theme.
76 * @param event The purple sound event to look up. 77 * @param event The purple sound event to look up.
77 * 78 *
78 * @returns The filename of the sound event. 79 * @returns The filename of the sound event.
79 */ 80 */
80 const gchar *purple_sound_theme_get_file(PurpleSoundTheme *theme, 81 const gchar *purple_sound_theme_get_file(PurpleSoundTheme *theme,
81 const gchar *event); 82 const gchar *event);
82 83
83 /** 84 /**
84 * Returns a copy of the directory and filename for the sound event 85 * Returns a copy of the directory and filename for the sound event
85 * 86 *
87 * @param theme The theme.
86 * @param event The purple sound event to look up 88 * @param event The purple sound event to look up
87 * 89 *
88 * @returns The directory + '/' + filename of the sound event. This is 90 * @returns The directory + '/' + filename of the sound event. This is
89 * a newly allocated string that should be freed with g_free. 91 * a newly allocated string that should be freed with g_free.
90 */ 92 */
92 const gchar *event); 94 const gchar *event);
93 95
94 /** 96 /**
95 * Sets the filename for a given sound event 97 * Sets the filename for a given sound event
96 * 98 *
97 * @param event the purple sound event to look up 99 * @param theme The theme.
98 * @param filename the name of the file to be used for the event 100 * @param event the purple sound event to look up
101 * @param filename the name of the file to be used for the event
99 */ 102 */
100 void purple_sound_theme_set_file(PurpleSoundTheme *theme, 103 void purple_sound_theme_set_file(PurpleSoundTheme *theme,
101 const gchar *event, 104 const gchar *event,
102 const gchar *filename); 105 const gchar *filename);
103 106