📄 gtkprogress.html
字号:
<HTML><HEAD><TITLE>GtkProgress</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkPreview"HREF="gtkpreview.html"><LINKREL="NEXT"TITLE="GtkProgressBar"HREF="gtkprogressbar.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkpreview.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkprogressbar.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKPROGRESS">GtkProgress</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN36695"></A><H2>Name</H2>GtkProgress -- the base class for <AHREF="gtkprogressbar.html">GtkProgressBar</A>.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN36699"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkprogress.html#GTKPROGRESS-STRUCT">GtkProgress</A>;void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-SHOW-TEXT">gtk_progress_set_show_text</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> show_text);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-TEXT-ALIGNMENT">gtk_progress_set_text_alignment</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> x_align, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> y_align);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-FORMAT-STRING">gtk_progress_set_format_string</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *format);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-ADJUSTMENT">gtk_progress_set_adjustment</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-PERCENTAGE">gtk_progress_set_percentage</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> percentage);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-VALUE">gtk_progress_set_value</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value);<AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> <AHREF="gtkprogress.html#GTK-PROGRESS-GET-VALUE">gtk_progress_get_value</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress);void <AHREF="gtkprogress.html#GTK-PROGRESS-SET-ACTIVITY-MODE">gtk_progress_set_activity_mode</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> activity_mode);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtkprogress.html#GTK-PROGRESS-GET-CURRENT-TEXT">gtk_progress_get_current_text</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtkprogress.html#GTK-PROGRESS-GET-TEXT-FROM-VALUE">gtk_progress_get_text_from_value</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value);<AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> <AHREF="gtkprogress.html#GTK-PROGRESS-GET-CURRENT-PERCENTAGE">gtk_progress_get_current_percentage</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress);<AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> <AHREF="gtkprogress.html#GTK-PROGRESS-GET-PERCENTAGE-FROM-VALUE">gtk_progress_get_percentage_from_value</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value);void <AHREF="gtkprogress.html#GTK-PROGRESS-CONFIGURE">gtk_progress_configure</A> (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> min, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> max); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36747"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----GtkProgress</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36752"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkprogress.html#GTKPROGRESS--ACTIVITY-MODE">activity-mode</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write "<AHREF="gtkprogress.html#GTKPROGRESS--SHOW-TEXT">show-text</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write "<AHREF="gtkprogress.html#GTKPROGRESS--TEXT-XALIGN">text-xalign</A>" <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> : Read / Write "<AHREF="gtkprogress.html#GTKPROGRESS--TEXT-YALIGN">text-yalign</A>" <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36763"></A><H2>Description</H2><P>A <AHREF="gtkprogress.html">GtkProgress</A> is the abstract base class used to derivea <AHREF="gtkprogressbar.html">GtkProgressBar</A> which provides a visual representation ofthe progress of a long running operation. </P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36768"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN36770"></A><H3><ANAME="GTKPROGRESS-STRUCT"></A>struct GtkProgress</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkProgress;</PRE></TD></TR></TABLE><P>The <AHREF="gtkprogress.html#GTKPROGRESS-STRUCT">GtkProgress</A> struct contains private data only.and should be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36776"></A><H3><ANAME="GTK-PROGRESS-SET-SHOW-TEXT"></A>gtk_progress_set_show_text ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_set_show_text (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> show_text);</PRE></TD></TR></TABLE><P>Controls whether progress text is shown.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36783"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>progress</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>show_text</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a boolean indicating whether the progress textis shown. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36797"></A><H3><ANAME="GTK-PROGRESS-SET-TEXT-ALIGNMENT"></A>gtk_progress_set_text_alignment ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_set_text_alignment (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> x_align, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> y_align);</PRE></TD></TR></TABLE><P>Controls the alignment of the text within the progress bar area.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36805"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>progress</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>x_align</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a number between 0.0 and 1.0 indicating the horizontalalignment of the progress text within the <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>y_align</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a number between 0.0 and 1.0 indicating the verticalalignment of the progress text within the <AHREF="gtkprogress.html">GtkProgress</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36825"></A><H3><ANAME="GTK-PROGRESS-SET-FORMAT-STRING"></A>gtk_progress_set_format_string ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_set_format_string (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *format);</PRE></TD></TR></TABLE><P>Sets a format string used to display text indicating thecurrent progress. The string can contain the following substitution characters:<P></P><UL><LI><P>%<TTCLASS="LITERAL">v</TT> - the current progress value.</P></LI><LI><P>%<TTCLASS="LITERAL">l</TT> - the lower bound for the progress value.</P></LI><LI><P>%<TTCLASS="LITERAL">u</TT> - the upper bound for the progress value.</P></LI><LI><P>%<TTCLASS="LITERAL">p</TT> - the current progress percentage.</P></LI></UL></P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36845"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>progress</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>format</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a string used to display progress text. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36859"></A><H3><ANAME="GTK-PROGRESS-SET-ADJUSTMENT"></A>gtk_progress_set_adjustment ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_set_adjustment (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment);</PRE></TD></TR></TABLE><P>Associates a <AHREF="gtkadjustment.html">GtkAdjustment</A> with the <AHREF="gtkprogress.html">GtkProgress</A>. A <AHREF="gtkadjustment.html">GtkAdjustment</A>is used to represent the upper and lower bounds and the step intervalof the underlying value for which progress is shown.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36869"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>progress</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>adjustment</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the <AHREF="gtkadjustment.html">GtkAdjustment</A> to be associated with the <AHREF="gtkprogress.html">GtkProgress</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36885"></A><H3><ANAME="GTK-PROGRESS-SET-PERCENTAGE"></A>gtk_progress_set_percentage ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_progress_set_percentage (<AHREF="gtkprogress.html">GtkProgress</A> *progress, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> percentage);</PRE></TD></TR></TABLE><P>Sets the current percentage completion for the <AHREF="gtkprogress.html">GtkProgress</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36893"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>progress</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogress.html">GtkProgress</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>percentage</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the percentage complete which must be between 0.0and 1.0. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36907"></A><H3><ANAME="GTK-PROGRESS-SET-VALUE"></A>gtk_progress_set_value ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -