* doc/hildon-sections.txt
* hildon/hildon-pannable-area.c
* hildon/hildon-banner.h
* hildon/hildon-banner.c: Documentation updates.
Fixes: MB#4643 (Documentation: hildon_banner_show_information()
memory management)
+2009-06-08 Alberto Garcia <agarcia@igalia.com>
+
+ * doc/hildon-sections.txt
+ * hildon/hildon-pannable-area.c
+ * hildon/hildon-banner.h
+ * hildon/hildon-banner.c: Documentation updates.
+
+ Fixes: MB#4643 (Documentation: hildon_banner_show_information()
+ memory management)
+
2009-06-05 Alejandro G. Castro <alex@igalia.com>
* hildon/hildon-calendar-popup.h:
2009-06-05 Alejandro G. Castro <alex@igalia.com>
* hildon/hildon-calendar-popup.h:
hildon_banner_show_information
hildon_banner_show_informationf
hildon_banner_show_information_with_markup
hildon_banner_show_information
hildon_banner_show_informationf
hildon_banner_show_information_with_markup
+hildon_banner_show_information_override_dnd
hildon_banner_show_animation
hildon_banner_show_progress
hildon_banner_set_text
hildon_banner_show_animation
hildon_banner_show_progress
hildon_banner_set_text
hildon_touch_selector_get_print_func
hildon_touch_selector_set_print_func_full
hildon_touch_selector_has_multiple_selection
hildon_touch_selector_get_print_func
hildon_touch_selector_set_print_func_full
hildon_touch_selector_has_multiple_selection
+hildon_touch_selector_optimal_size_request
<SUBSECTION Standard>
HILDON_TOUCH_SELECTOR
HILDON_IS_TOUCH_SELECTOR
<SUBSECTION Standard>
HILDON_TOUCH_SELECTOR
HILDON_IS_TOUCH_SELECTOR
HILDON_TIME_SELECTOR_GET_CLASS
HildonTimeSelectorClass
HildonTimeSelectorPrivate
HILDON_TIME_SELECTOR_GET_CLASS
HildonTimeSelectorClass
HildonTimeSelectorPrivate
+HILDON_TYPE_TIME_SELECTOR_FORMAT_POLICY
+HildonTimeSelectorFormatPolicy
+hildon_time_selector_format_policy_get_type
hildon_gtk_icon_view_set_ui_mode
hildon_gtk_window_set_do_not_disturb
hildon_gtk_window_set_progress_indicator
hildon_gtk_icon_view_set_ui_mode
hildon_gtk_window_set_do_not_disturb
hildon_gtk_window_set_progress_indicator
+hildon_gtk_window_take_screenshot
HildonPortraitFlags
hildon_gtk_window_set_portrait_flags
hildon_gtk_hscale_new
HildonPortraitFlags
hildon_gtk_window_set_portrait_flags
hildon_gtk_hscale_new
- * SECTION:hildon-banner
- * @short_description: A widget used to display timed notifications.
+ * SECTION:hildon-banner
+ * @short_description: A widget used to display timed notifications.
*
* #HildonBanner is a small, pop-up window that can be used to display
* a short, timed notification or information to the user. It can
*
* #HildonBanner is a small, pop-up window that can be used to display
* a short, timed notification or information to the user. It can
* hildon_gtk_window_set_progress_indicator() for the preferred way of
* showing progress notifications in Hildon 2.2.
*
* hildon_gtk_window_set_progress_indicator() for the preferred way of
* showing progress notifications in Hildon 2.2.
*
- * Information banners dissapear automatically after a certain
+ * Information banners are automatically destroyed after a certain
* period. This is stored in the #HildonBanner:timeout property (in
* miliseconds), and can be changed using hildon_banner_set_timeout().
*
* Note that #HildonBanner<!-- -->s should only be used to display
* non-critical pieces of information.
* period. This is stored in the #HildonBanner:timeout property (in
* miliseconds), and can be changed using hildon_banner_set_timeout().
*
* Note that #HildonBanner<!-- -->s should only be used to display
* non-critical pieces of information.
+ *
+ * <example>
+ * <title>Using the HildonBanner widget</title>
+ * <programlisting>
+ * void show_info_banner (GtkWidget *parent)
+ * {
+ * GtkWidget *banner;
+ * <!-- -->
+ * banner = hildon_banner_show_information (widget, NULL, "Information banner");
+ * hildon_banner_set_timeout (HILDON_BANNER (banner), 9000);
+ * <!-- -->
+ * return;
+ * }
+ * </programlisting>
+ * </example>
/**
* HildonBanner:timeout:
*
/**
* HildonBanner:timeout:
*
- * The time before making the banner banner go away. This needs
+ * The time before destroying the banner. This needs
* to be adjusted before the banner is mapped to the screen.
*
*/
* to be adjusted before the banner is mapped to the screen.
*
*/
* any value that you pass will be ignored
* @text: Text to display
*
* any value that you pass will be ignored
* @text: Text to display
*
- * This function creates and displays an information banner that
- * automatically goes away after certain time period. For each window
- * in your application there can only be one timed banner, so if you
- * spawn a new banner before the earlier one has timed out, the
- * previous one will be replaced.
+ * This function creates and displays an information banner that is
+ * automatically destroyed after a certain time period (see
+ * hildon_banner_set_timeout()). For each window in your application
+ * there can only be one timed banner, so if you spawn a new banner
+ * before the earlier one has timed out, the previous one will be
+ * replaced.
*
* Returns: The newly created banner
*
*
* Returns: The newly created banner
*
* @widget: the #GtkWidget that is the owner of the banner
* @text: Text to display
*
* @widget: the #GtkWidget that is the owner of the banner
* @text: Text to display
*
- * Equivalent to hildon_banner_show_information() but it overrides the do not
- * disturb flag, in the special cases that could be needed. It is required
- * because this method calls internally gtk_widget_show before returns the banner,
- * but the do not disturb flag is checked on the mapping of the widget
- *
+ * Equivalent to hildon_banner_show_information(), but overriding the
+ * "do not disturb" flag.
*
* Returns: The newly created banner
*
*
* Returns: The newly created banner
*
* @format: a printf-like format string
* @Varargs: arguments for the format string
*
* @format: a printf-like format string
* @Varargs: arguments for the format string
*
- * A helper function for #hildon_banner_show_information with
+ * A helper function for hildon_banner_show_information() with
* string formatting.
*
* Returns: the newly created banner
* string formatting.
*
* Returns: the newly created banner
* any value that you pass will be ignored
* @markup: a markup string to display (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
*
* any value that you pass will be ignored
* @markup: a markup string to display (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
*
- * This function creates and displays an information banner that
- * automatically goes away after certain time period. For each window
- * in your application there can only be one timed banner, so if you
- * spawn a new banner before the earlier one has timed out, the
- * previous one will be replaced.
+ * This function creates and displays an information banner that is
+ * automatically destroyed after certain time period (see
+ * hildon_banner_set_timeout()). For each window in your application
+ * there can only be one timed banner, so if you spawn a new banner
+ * before the earlier one has timed out, the previous one will be
+ * replaced.
*
* Returns: the newly created banner
*
*
* Returns: the newly created banner
*
* notifications with timed banners. In this case the banners are
* located so that you can somehow see both.
*
* notifications with timed banners. In this case the banners are
* located so that you can somehow see both.
*
- * Please note that banners are destroyed automatically once the
+ * Unlike information banners (created with
+ * hildon_banner_show_information()), animation banners are not
+ * destroyed automatically using a timeout. You have to destroy them
+ * yourself.
+ *
+ * Please note also that these banners are destroyed automatically if the
* window they are attached to is closed. The pointer that you receive
* with this function does not contain additional references, so it
* can become invalid without warning (this is true for all toplevel
* windows in gtk). To make sure that the banner does not disappear
* automatically, you can separately ref the return value (this
* doesn't prevent the banner from disappearing, just the object from
* window they are attached to is closed. The pointer that you receive
* with this function does not contain additional references, so it
* can become invalid without warning (this is true for all toplevel
* windows in gtk). To make sure that the banner does not disappear
* automatically, you can separately ref the return value (this
* doesn't prevent the banner from disappearing, just the object from
- * being finalized). In this case you have to call both
- * gtk_widget_destroy() followed by g_object_unref() (in this order).
+ * being finalized). In this case you have to call
+ * gtk_widget_destroy() followed by g_object_unref().
*
* Returns: a #HildonBanner widget. You must call gtk_widget_destroy()
* once you are done with the banner.
*
* Returns: a #HildonBanner widget. You must call gtk_widget_destroy()
* once you are done with the banner.
* any value that you pass will be ignored
* @text: text to display.
*
* any value that you pass will be ignored
* @text: text to display.
*
- * Shows progress notification. See #hildon_banner_show_animation
+ * Shows progress notification. See hildon_banner_show_animation()
* for more information.
*
* Returns: a #HildonBanner widget. You must call #gtk_widget_destroy
* for more information.
*
* Returns: a #HildonBanner widget. You must call #gtk_widget_destroy
* @timeout: timeout to set in miliseconds.
*
* Sets the timeout on the banner. After the given amount of miliseconds
* @timeout: timeout to set in miliseconds.
*
* Sets the timeout on the banner. After the given amount of miliseconds
- * has elapsed the banner will go away. Note that settings this only makes
- * sense on the banners that are timed and that have not been yet displayed
+ * has elapsed the banner will be destroyed. Setting this only makes
+ * sense on banners that are timed and that have not been yet displayed
* on the screen.
*
* Note that this method only has effect if @self is an information
* on the screen.
*
* Note that this method only has effect if @self is an information
hildon_banner_set_markup (HildonBanner *self,
const gchar *markup);
hildon_banner_set_markup (HildonBanner *self,
const gchar *markup);
+#ifndef HILDON_DISABLE_DEPRECATED
void
hildon_banner_set_fraction (HildonBanner *self,
gdouble fraction);
void
hildon_banner_set_fraction (HildonBanner *self,
gdouble fraction);
-#ifndef HILDON_DISABLE_DEPRECATED
void
hildon_banner_set_icon (HildonBanner *self,
const gchar *icon_name);
void
hildon_banner_set_icon (HildonBanner *self,
const gchar *icon_name);
GTK_CONTAINER_CLASS (hildon_pannable_area_parent_class)->remove (container, child);
}
GTK_CONTAINER_CLASS (hildon_pannable_area_parent_class)->remove (container, child);
}
* This method calculates a factor necessary to determine the initial distance
* to jump in hildon_pannable_area_scroll_to(). For fixed time and frames per
* second, we know in how many frames 'n' we need to reach the destination
* This method calculates a factor necessary to determine the initial distance
* to jump in hildon_pannable_area_scroll_to(). For fixed time and frames per
* second, we know in how many frames 'n' we need to reach the destination
* vel_factor = 1 + decel_factor + ... + decel_factor^(n-1).
*
* That's the gem we calculate in this method.
* vel_factor = 1 + decel_factor + ... + decel_factor^(n-1).
*
* That's the gem we calculate in this method.
static void
hildon_pannable_calculate_vel_factor (HildonPannableArea * self)
{
static void
hildon_pannable_calculate_vel_factor (HildonPannableArea * self)
{