📄 gtkprogressbar.html
字号:
<HTML><HEAD><TITLE>GtkProgressBar</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="GtkProgress"HREF="gtkprogress.html"><LINKREL="NEXT"TITLE="GtkRadioButton"HREF="gtkradiobutton.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="gtkprogress.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="gtkradiobutton.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKPROGRESSBAR">GtkProgressBar</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN37138"></A><H2>Name</H2>GtkProgressBar -- a widget which indicates progress visually.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN37141"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkprogressbar.html#GTKPROGRESSBAR-STRUCT">GtkProgressBar</A>;enum <AHREF="gtkprogressbar.html#GTKPROGRESSBARSTYLE">GtkProgressBarStyle</A>;enum <AHREF="gtkprogressbar.html#GTKPROGRESSBARORIENTATION">GtkProgressBarOrientation</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-NEW">gtk_progress_bar_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-NEW-WITH-ADJUSTMENT">gtk_progress_bar_new_with_adjustment</A> (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-SET-BAR-STYLE">gtk_progress_bar_set_bar_style</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF="gtkprogressbar.html#GTKPROGRESSBARSTYLE">GtkProgressBarStyle</A> style);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-SET-DISCRETE-BLOCKS">gtk_progress_bar_set_discrete_blocks</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> blocks);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-SET-ACTIVITY-STEP">gtk_progress_bar_set_activity_step</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> step);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-SET-ACTIVITY-BLOCKS">gtk_progress_bar_set_activity_blocks</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> blocks);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-SET-ORIENTATION">gtk_progress_bar_set_orientation</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF="gtkprogressbar.html#GTKPROGRESSBARORIENTATION">GtkProgressBarOrientation</A> orientation);void <AHREF="gtkprogressbar.html#GTK-PROGRESS-BAR-UPDATE">gtk_progress_bar_update</A> (<AHREF="gtkprogressbar.html">GtkProgressBar</A> *pbar, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> percentage); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37170"></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> +----<AHREF="gtkprogress.html">GtkProgress</A> +----GtkProgressBar</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37176"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--ADJUSTMENT">adjustment</A>" <AHREF="gtkadjustment.html">GtkAdjustment</A> : Read / Write / Construct "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--ORIENTATION">orientation</A>" <AHREF="gtkprogressbar.html#GTKPROGRESSBARORIENTATION">GtkProgressBarOrientation</A> : Read / Write "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--BAR-STYLE">bar-style</A>" <AHREF="gtkprogressbar.html#GTKPROGRESSBARSTYLE">GtkProgressBarStyle</A> : Read / Write "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--ACTIVITY-STEP">activity-step</A>" <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> : Read / Write "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--ACTIVITY-BLOCKS">activity-blocks</A>" <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> : Read / Write "<AHREF="gtkprogressbar.html#GTKPROGRESSBAR--DISCRETE-BLOCKS">discrete-blocks</A>" <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37191"></A><H2>Description</H2><P>The <AHREF="gtkprogressbar.html">GtkProgressBar</A> is typically used to display the progress of a longrunning operation. It provides a visual clue that processingis underway. The <AHREF="gtkprogressbar.html">GtkProgressBar</A> can be used in two differentmodes: percentage mode and activity mode.</P><P>When an application can determine how much work needs to take place (e.g. read a fixed number of bytes from a file) and can monitor itsprogress, it can use the <AHREF="gtkprogressbar.html">GtkProgressBar</A> in percentage mode and the usersees a growing bar indicating the percentage of the work that hasbeen completed. In this mode, the application is required to calleither the <AHREF="gtkprogress.html#GTK-PROGRESS-SET-PERCENTAGE">gtk_progress_set_percentage</A>() or <AHREF="gtkprogress.html#GTK-PROGRESS-SET-VALUE">gtk_progress_set_value</A>()functions periodically to update the progress bar.</P><P>When an application has no accurate way of knowing the amount of workto do, it can use the <AHREF="gtkprogressbar.html">GtkProgressBar</A> in activity mode. In this modethe progress bar shows activity by a block moving back and forth withinthe progress area.</P><P>There is quite a bit of flexibility provided to control the appearanceof the <AHREF="gtkprogressbar.html">GtkProgressBar</A>. Functions are provided to control the orientation of the bar, optional text which can be displayed along withthe bar, and the style in which the bar grows.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN37204"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN37206"></A><H3><ANAME="GTKPROGRESSBAR-STRUCT"></A>struct GtkProgressBar</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkProgressBar;</PRE></TD></TR></TABLE><P>The <AHREF="gtkprogressbar.html#GTKPROGRESSBAR-STRUCT">GtkProgressBar</A> struct contains private data only, and should be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37212"></A><H3><ANAME="GTKPROGRESSBARSTYLE"></A>enum GtkProgressBarStyle</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">typedef enum{ GTK_PROGRESS_CONTINUOUS, GTK_PROGRESS_DISCRETE} GtkProgressBarStyle;</PRE></TD></TR></TABLE><P>An enumeration representing the styles for drawing the progress bar.<DIVCLASS="INFORMALTABLE"><ANAME="AEN37217"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#F0F0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_CONTINUOUS</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The progress bar grows in a smooth, continuous manner.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_DISCRETE</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The progress bar grows in discrete, visible blocks.</TD></TR></TBODY></TABLE><P></P></DIV></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37228"></A><H3><ANAME="GTKPROGRESSBARORIENTATION"></A>enum GtkProgressBarOrientation</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">typedef enum{ GTK_PROGRESS_LEFT_TO_RIGHT, GTK_PROGRESS_RIGHT_TO_LEFT, GTK_PROGRESS_BOTTOM_TO_TOP, GTK_PROGRESS_TOP_TO_BOTTOM} GtkProgressBarOrientation;</PRE></TD></TR></TABLE><P>An enumeration representing possible orientations and growthdirections for the visible progress bar.<DIVCLASS="INFORMALTABLE"><ANAME="AEN37233"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#F0F0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_LEFT_TO_RIGHT</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A horizontal progress bar growing from left to right.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_RIGHT_TO_LEFT</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A horizontal progress bar growing from right to left.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_BOTTOM_TO_TOP</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A vertical progress bar growing from bottom to top.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">GTK_PROGRESS_TOP_TO_BOTTOM</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">A vertical progress bar growing from top to bottom.</TD></TR></TBODY></TABLE><P></P></DIV></P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37250"></A><H3><ANAME="GTK-PROGRESS-BAR-NEW"></A>gtk_progress_bar_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_progress_bar_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkprogressbar.html">GtkProgressBar</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37257"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogressbar.html">GtkProgressBar</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37267"></A><H3><ANAME="GTK-PROGRESS-BAR-NEW-WITH-ADJUSTMENT"></A>gtk_progress_bar_new_with_adjustment ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_progress_bar_new_with_adjustment (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkprogressbar.html">GtkProgressBar</A> with an associated <AHREF="gtkadjustment.html">GtkAdjustment</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN37276"></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>adjustment</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkadjustment.html">GtkAdjustment</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkprogressbar.html">GtkProgressBar</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN37291"></A><H3><ANAME="GTK-PROGRESS-BAR-SET-BAR-STYLE"></A⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -