📄 gtkadjustment.html
字号:
<HTML><HEAD><TITLE>GtkAdjustment</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="GtkAccelLabel"HREF="gtkaccellabel.html"><LINKREL="NEXT"TITLE="GtkAlignment"HREF="gtkalignment.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="gtkaccellabel.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="gtkalignment.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKADJUSTMENT">GtkAdjustment</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN12887"></A><H2>Name</H2>GtkAdjustment -- a <AHREF="gtkobject.html">GtkObject</A> representing an adjustable bounded value.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN12891"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkadjustment.html#GTKADJUSTMENT-STRUCT">GtkAdjustment</A>;<AHREF="gtkobject.html">GtkObject</A>* <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-NEW">gtk_adjustment_new</A> (<AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> lower, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> upper, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> step_increment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_increment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_size);void <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-SET-VALUE">gtk_adjustment_set_value</A> (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value);void <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-CLAMP-PAGE">gtk_adjustment_clamp_page</A> (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> lower, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> upper);void <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-CHANGED">gtk_adjustment_changed</A> (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment);void <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-VALUE-CHANGED">gtk_adjustment_value_changed</A> (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12914"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkdata.html">GtkData</A> +----GtkAdjustment</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12919"></A><H2>Signal Prototypes</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkadjustment.html#GTKADJUSTMENT-CHANGED">changed</A>" void user_function (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);"<AHREF="gtkadjustment.html#GTKADJUSTMENT-VALUE-CHANGED">value-changed</A>" void user_function (<AHREF="gtkadjustment.html">GtkAdjustment</A> *adjustment, <AHREF=../glib/glib-basic-types.html#GPOINTER>gpointer</A> user_data);</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12928"></A><H2>Description</H2><P>The <AHREF="gtkadjustment.html">GtkAdjustment</A> object represents a value which has an associated lowerand upper bound, together with step and page increments, and a page size.It is used within several GTK+ widgets, including<AHREF="gtkspinbutton.html">GtkSpinButton</A>, <AHREF="gtkviewport.html">GtkViewport</A>, and <AHREF="gtkrange.html">GtkRange</A> (which is a base class for<AHREF="gtkhscrollbar.html">GtkHScrollbar</A>, <AHREF="gtkvscrollbar.html">GtkVScrollbar</A>, <AHREF="gtkhscale.html">GtkHScale</A>, and <AHREF="gtkvscale.html">GtkVScale</A>).</P><P>The <AHREF="gtkadjustment.html">GtkAdjustment</A> object does not update the value itself. Insteadit is left up to the owner of the <AHREF="gtkadjustment.html">GtkAdjustment</A> to control the value.</P><P>The owner of the <AHREF="gtkadjustment.html">GtkAdjustment</A> typically calls the<AHREF="gtkadjustment.html#GTK-ADJUSTMENT-VALUE-CHANGED">gtk_adjustment_value_changed</A>() and <AHREF="gtkadjustment.html#GTK-ADJUSTMENT-CHANGED">gtk_adjustment_changed</A>() functionsafter changing the value and its bounds. This results in the emission of the"value_changed" or "changed" signal respectively.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN12946"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN12948"></A><H3><ANAME="GTKADJUSTMENT-STRUCT"></A>struct GtkAdjustment</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkAdjustment;</PRE></TD></TR></TABLE><P>The <AHREF="gtkadjustment.html#GTKADJUSTMENT-STRUCT">GtkAdjustment</A> struct contains the following fields.<DIVCLASS="INFORMALTABLE"><ANAME="AEN12954"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFF0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> lower;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the minimum value.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> upper;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the maximum value.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the current value.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> step_increment;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the increment to use to make minor changes to the value.In a <AHREF="gtkscrollbar.html">GtkScrollbar</A> this increment is used when the mouse is clicked on thearrows at the top and bottom of the scrollbar, to scroll by a small amount.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_increment;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the increment to use to make major changes to the value.In a <AHREF="gtkscrollbar.html">GtkScrollbar</A> this increment is used when the mouse is clicked in thetrough, to scroll by a large amount.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_size;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the page size.In a <AHREF="gtkscrollbar.html">GtkScrollbar</A> this is the size of the area which is currently visible.</TD></TR></TBODY></TABLE><P></P></DIV> </P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN12986"></A><H3><ANAME="GTK-ADJUSTMENT-NEW"></A>gtk_adjustment_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkobject.html">GtkObject</A>* gtk_adjustment_new (<AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> value, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> lower, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> upper, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> step_increment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_increment, <AHREF=../glib/glib-basic-types.html#GFLOAT>gfloat</A> page_size);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkadjustment.html">GtkAdjustment</A>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN12999"></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>value</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the initial value.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>lower</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the minimum value.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>upper</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the maximum value.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>step_increment</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the step increment.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>page_increment</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the page increment.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>page_size</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the page size.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkadjustment.html">GtkAdjustment</A>. </TD></TR⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -