forked from AuroraMiddleware/gtk
Fix typos in pkg-config invokations. (#72476)
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config invokations. (#72476) Fixes for #72478: * gtk/tmpl/gtkprogressbar.sgml: Add note about new GtkProgressBar API to introduction. * gtk/gtk-sections.txt: Reorder GtkProgressBar functions to move undeprecated API to top.
This commit is contained in:
Matthias Clasen
parent
c0c90c9e58
commit
14a2eb7884
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,8 @@
|
||||
2002-02-25 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
* docs/tutorial/gtk-tut.sgml: Fix typos in pkg-config
|
||||
invokations. (#72476)
|
||||
|
||||
Mon Feb 25 18:59:27 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/gtktooltips.c (start_keyboard_mode): Set the keyboard-mode
|
||||
|
||||
@ -1,3 +1,13 @@
|
||||
2002-02-26 Matthias Clasen <maclas@gmx.de>
|
||||
|
||||
Fixes for #72478:
|
||||
|
||||
* gtk/tmpl/gtkprogressbar.sgml: Add note about new GtkProgressBar
|
||||
API to introduction.
|
||||
|
||||
* gtk/gtk-sections.txt: Reorder GtkProgressBar functions to move
|
||||
undeprecated API to top.
|
||||
|
||||
Sat Feb 23 23:39:14 2002 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* gtk/tmpl/gtktreemodel.sgml: Document gtk_tree_path_new_root(),
|
||||
|
||||
@ -1878,23 +1878,23 @@ gtk_progress_get_type
|
||||
<FILE>gtkprogressbar</FILE>
|
||||
<TITLE>GtkProgressBar</TITLE>
|
||||
GtkProgressBar
|
||||
GtkProgressBarStyle
|
||||
GtkProgressBarOrientation
|
||||
gtk_progress_bar_new
|
||||
gtk_progress_bar_pulse
|
||||
gtk_progress_bar_set_text
|
||||
gtk_progress_bar_set_fraction
|
||||
gtk_progress_bar_set_pulse_step
|
||||
gtk_progress_bar_set_orientation
|
||||
GtkProgressBarOrientation
|
||||
gtk_progress_bar_get_text
|
||||
gtk_progress_bar_get_fraction
|
||||
gtk_progress_bar_get_pulse_step
|
||||
gtk_progress_bar_get_text
|
||||
gtk_progress_bar_get_orientation
|
||||
gtk_progress_bar_new_with_adjustment
|
||||
gtk_progress_bar_set_bar_style
|
||||
GtkProgressBarStyle
|
||||
gtk_progress_bar_set_discrete_blocks
|
||||
gtk_progress_bar_set_activity_step
|
||||
gtk_progress_bar_set_activity_blocks
|
||||
gtk_progress_bar_set_orientation
|
||||
gtk_progress_bar_get_orientation
|
||||
gtk_progress_bar_update
|
||||
<SUBSECTION Standard>
|
||||
GTK_PROGRESS_BAR
|
||||
|
||||
@ -18,24 +18,38 @@ When an application can determine how much work needs to take place
|
||||
progress, it can use the #GtkProgressBar in percentage mode and the user
|
||||
sees a growing bar indicating the percentage of the work that has
|
||||
been completed. In this mode, the application is required to call
|
||||
either the gtk_progress_set_percentage() or gtk_progress_set_value()
|
||||
functions periodically to update the progress bar.
|
||||
gtk_progress_bar_set_fraction() periodically to update the progress bar.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
When an application has no accurate way of knowing the amount of work
|
||||
to do, it can use the #GtkProgressBar in activity mode. In this mode
|
||||
the progress bar shows activity by a block moving back and forth within
|
||||
the progress area.
|
||||
to do, it can use the #GtkProgressBar in activity mode, which shows activity
|
||||
by a block moving back and forth within the progress area. In this mode,
|
||||
the application is required to call gtk_progress_bar_pulse() perodically
|
||||
to update the progress bar.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
There is quite a bit of flexibility provided to control the appearance
|
||||
of the #GtkProgressBar. Functions are provided to control the
|
||||
orientation of the bar, optional text which can be displayed along with
|
||||
the bar, and the style in which the bar grows.
|
||||
orientation of the bar, optional text can be displayed along with
|
||||
the bar, and the step size used in activity mode can be set.
|
||||
</para>
|
||||
|
||||
<note>
|
||||
<para>
|
||||
The #GtkProgressBar/#GtkProgress API in GTK 1.2 was bloated, needlessly complex
|
||||
and hard to use properly. Therefore #GtkProgress has been deprecated
|
||||
completely and the #GtkProgressBar API has been reduced to the following 9
|
||||
functions: gtk_progress_bar_new(), gtk_progress_bar_pulse(), gtk_progress_bar_set_text(),
|
||||
gtk_progress_bar_set_fraction(), gtk_progress_bar_set_pulse_step(),
|
||||
gtk_progress_bar_set_orientation(), gtk_progress_bar_get_text(),
|
||||
gtk_progress_bar_get_fraction(), gtk_progress_bar_get_pulse_step(). These have
|
||||
been grouped at the beginning of this section, followed by a large chunk of
|
||||
deprecated 1.2 compatibility functions.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
<!-- ##### SECTION See_Also ##### -->
|
||||
<para>
|
||||
|
||||
@ -48,67 +62,6 @@ and should be accessed using the functions below.
|
||||
</para>
|
||||
|
||||
|
||||
<!-- ##### ENUM GtkProgressBarStyle ##### -->
|
||||
<para>
|
||||
An enumeration representing the styles for drawing the progress bar.
|
||||
|
||||
<informaltable pgwide=1 frame="none" role="enum">
|
||||
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_CONTINUOUS</entry>
|
||||
<entry>The progress bar grows in a smooth, continuous manner.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_DISCRETE</entry>
|
||||
<entry>The progress bar grows in discrete, visible blocks.</entry>
|
||||
</row>
|
||||
|
||||
</tbody></tgroup></informaltable>
|
||||
</para>
|
||||
|
||||
@GTK_PROGRESS_CONTINUOUS:
|
||||
@GTK_PROGRESS_DISCRETE:
|
||||
|
||||
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
|
||||
<para>
|
||||
An enumeration representing possible orientations and growth
|
||||
directions for the visible progress bar.
|
||||
|
||||
<informaltable pgwide=1 frame="none" role="enum">
|
||||
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_LEFT_TO_RIGHT</entry>
|
||||
<entry>A horizontal progress bar growing from left to right.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_RIGHT_TO_LEFT</entry>
|
||||
<entry>A horizontal progress bar growing from right to left.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_BOTTOM_TO_TOP</entry>
|
||||
<entry>A vertical progress bar growing from bottom to top.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_TOP_TO_BOTTOM</entry>
|
||||
<entry>A vertical progress bar growing from top to bottom.</entry>
|
||||
</row>
|
||||
|
||||
</tbody></tgroup></informaltable>
|
||||
</para>
|
||||
|
||||
@GTK_PROGRESS_LEFT_TO_RIGHT:
|
||||
@GTK_PROGRESS_RIGHT_TO_LEFT:
|
||||
@GTK_PROGRESS_BOTTOM_TO_TOP:
|
||||
@GTK_PROGRESS_TOP_TO_BOTTOM:
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_new ##### -->
|
||||
<para>
|
||||
Creates a new #GtkProgressBar.
|
||||
@ -152,6 +105,61 @@ Creates a new #GtkProgressBar.
|
||||
@fraction:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_set_orientation ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@pbar:
|
||||
@orientation:
|
||||
|
||||
|
||||
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
|
||||
<para>
|
||||
An enumeration representing possible orientations and growth
|
||||
directions for the visible progress bar.
|
||||
|
||||
<informaltable pgwide=1 frame="none" role="enum">
|
||||
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_LEFT_TO_RIGHT</entry>
|
||||
<entry>A horizontal progress bar growing from left to right.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_RIGHT_TO_LEFT</entry>
|
||||
<entry>A horizontal progress bar growing from right to left.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_BOTTOM_TO_TOP</entry>
|
||||
<entry>A vertical progress bar growing from bottom to top.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_TOP_TO_BOTTOM</entry>
|
||||
<entry>A vertical progress bar growing from top to bottom.</entry>
|
||||
</row>
|
||||
|
||||
</tbody></tgroup></informaltable>
|
||||
</para>
|
||||
|
||||
@GTK_PROGRESS_LEFT_TO_RIGHT:
|
||||
@GTK_PROGRESS_RIGHT_TO_LEFT:
|
||||
@GTK_PROGRESS_BOTTOM_TO_TOP:
|
||||
@GTK_PROGRESS_TOP_TO_BOTTOM:
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_get_text ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@pbar:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_get_fraction ##### -->
|
||||
<para>
|
||||
|
||||
@ -170,7 +178,7 @@ Creates a new #GtkProgressBar.
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_get_text ##### -->
|
||||
<!-- ##### FUNCTION gtk_progress_bar_get_orientation ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
@ -198,6 +206,30 @@ Sets the style of the #GtkProgressBar. The default style is
|
||||
@style: a #GtkProgressBarStyle value indicating the desired style.
|
||||
|
||||
|
||||
<!-- ##### ENUM GtkProgressBarStyle ##### -->
|
||||
<para>
|
||||
An enumeration representing the styles for drawing the progress bar.
|
||||
|
||||
<informaltable pgwide=1 frame="none" role="enum">
|
||||
<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_CONTINUOUS</entry>
|
||||
<entry>The progress bar grows in a smooth, continuous manner.</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>GTK_PROGRESS_DISCRETE</entry>
|
||||
<entry>The progress bar grows in discrete, visible blocks.</entry>
|
||||
</row>
|
||||
|
||||
</tbody></tgroup></informaltable>
|
||||
</para>
|
||||
|
||||
@GTK_PROGRESS_CONTINUOUS:
|
||||
@GTK_PROGRESS_DISCRETE:
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_set_discrete_blocks ##### -->
|
||||
<para>
|
||||
Sets the number of blocks that the progress bar is divided into
|
||||
@ -230,24 +262,6 @@ mode. Larger numbers make the visible block smaller.
|
||||
@blocks: number of blocks which can fit within the progress bar area.
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_set_orientation ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@pbar:
|
||||
@orientation:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_get_orientation ##### -->
|
||||
<para>
|
||||
|
||||
</para>
|
||||
|
||||
@pbar:
|
||||
@Returns:
|
||||
|
||||
|
||||
<!-- ##### FUNCTION gtk_progress_bar_update ##### -->
|
||||
<para>
|
||||
This function is deprecated. Please use gtk_progress_set_value() or
|
||||
|
||||
@ -5,7 +5,7 @@
|
||||
<book id="gtk-tut">
|
||||
|
||||
<bookinfo>
|
||||
<date>February 20, 2002</date>
|
||||
<date>February 25, 2002</date>
|
||||
<title>GTK+ 2.0 Tutorial</title>
|
||||
<authorgroup>
|
||||
<author>
|
||||
@ -191,7 +191,7 @@ int main( int argc,
|
||||
|
||||
<para>You can compile the above program with gcc using:</para>
|
||||
<para><literallayout>
|
||||
<literal>gcc base.c -o base `pkg-config --cflags --libs gtk-2.0`</literal>
|
||||
<literal>gcc base.c -o base `pkg-config --cflags --libs gtk+-2.0`</literal>
|
||||
</literallayout></para>
|
||||
|
||||
<para>The meaning of the unusual compilation options is explained below in
|
||||
@ -395,8 +395,8 @@ int main( int argc,
|
||||
<para>To compile use:</para>
|
||||
|
||||
<para><literallayout>
|
||||
<literal>gcc -Wall -g helloworld.c -o helloworld `pkg-config --cflags gtk-2.0` \</literal>
|
||||
<literal> `pkg-config --libs gtk-2.0`</literal>
|
||||
<literal>gcc -Wall -g helloworld.c -o helloworld `pkg-config --cflags gtk+-2.0` \</literal>
|
||||
<literal> `pkg-config --libs gtk+-2.0`</literal>
|
||||
</literallayout></para>
|
||||
|
||||
<para>This uses the program <literal>pkg-config</literal>, which can be obtained from
|
||||
@ -2682,7 +2682,7 @@ struct _GtkAdjustment
|
||||
|
||||
<para>If you don't like to poke directly at struct internals like a
|
||||
<emphasis>real</emphasis> C programmer, you can use the following accessor to
|
||||
inspect the <literal>value</literal> of an adjustment:
|
||||
inspect the <literal>value</literal> of an adjustment:</para>
|
||||
|
||||
<programlisting role="C">
|
||||
gdouble gtk_adjustment_get_value( GtkAdjustment *adjustment);
|
||||
|
||||
Loading…
Reference in New Issue
Block a user