gtkpreview.html

该压缩包包含了GTK+的大量API函数

NAME="AEN36474"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>preview</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkpreview.html"
>GtkPreview</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new data for the portion. It should contain
       <TT
CLASS="PARAMETER"
><I
>w</I
></TT
> bytes of data if the preview is of type
       GTK_TYPE_GRAYSCALE, and 3*<TT
CLASS="PARAMETER"
><I
>w</I
></TT
> bytes of data
       if the preview is of type GTK_TYPE_COLOR.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the starting value on the row to set.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the row to change.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>w</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the number of pixels in the row to change.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36502"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-EXPAND"
></A
>gtk_preview_set_expand ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_expand          (<A
HREF="gtkpreview.html"
>GtkPreview</A
> *preview,
                                             <A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> expand);</PRE
></TD
></TR
></TABLE
><P
>Determines the way that the the preview widget behaves
when the size it is allocated is larger than the requested
size. If <TT
CLASS="PARAMETER"
><I
>expand</I
></TT
> is <TT
CLASS="LITERAL"
>FALSE</TT
>, then the preview's window
and buffer will be no larger than the size set with 
<A
HREF="gtkpreview.html#GTK-PREVIEW-SIZE"
>gtk_preview_size</A
>(), and the data set will be centered
in the allocation if it is larger. If <TT
CLASS="PARAMETER"
><I
>expand</I
></TT
> is <TT
CLASS="LITERAL"
>TRUE</TT
>
then the window and buffer will expand with the allocation;
the application is responsible for catching
the "size_allocate" signal and providing the data 
appropriate for this size.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36514"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>preview</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkpreview.html"
>GtkPreview</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>expand</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>whether the preview's window should expand or not.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36528"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-GAMMA"
></A
>gtk_preview_set_gamma ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_gamma           (double gamma);</PRE
></TD
></TR
></TABLE
><P
>Set the gamma-correction value for all preview widgets.
(This function will eventually be replaced with a
function that sets a per-preview-widget gamma value).
The resulting intensity is given by:
<TT
CLASS="LITERAL"
>destination_value * pow (source_value/255, 1/gamma)</TT
>.
The gamma value is applied when the data is
set with <A
HREF="gtkpreview.html#GTK-PREVIEW-DRAW-ROW"
>gtk_preview_draw_row</A
>() so changing this
value will not affect existing data in preview
widgets.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36536"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>gamma</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the new gamma value.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36545"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-COLOR-CUBE"
></A
>gtk_preview_set_color_cube ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_color_cube      (<A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nred_shades,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> ngreen_shades,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> nblue_shades,
                                             <A
HREF=../glib/glib-basic-types.html#GUINT
>guint</A> ngray_shades);</PRE
></TD
></TR
></TABLE
><P
>This function is deprecated and does nothing. GdkRGB
automatically picks an optimium color cube for the
display.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36554"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nred_shades</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ngreen_shades</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nblue_shades</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>ngray_shades</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36575"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-INSTALL-CMAP"
></A
>gtk_preview_set_install_cmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_install_cmap    (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> install_cmap);</PRE
></TD
></TR
></TABLE
><P
>This function is deprecated
and does nothing. GdkRGB will automatically pick
a private colormap if it cannot allocate sufficient
colors.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36581"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>install_cmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36590"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-RESERVED"
></A
>gtk_preview_set_reserved ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_reserved        (<A
HREF=../glib/glib-basic-types.html#GINT
>gint</A> nreserved);</PRE
></TD
></TR
></TABLE
><P
>This function is deprecated and does nothing.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36596"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>nreserved</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>ignored.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36605"
></A
><H3
><A
NAME="GTK-PREVIEW-SET-DITHER"
></A
>gtk_preview_set_dither ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_set_dither          (<A
HREF="gtkpreview.html"
>GtkPreview</A
> *preview,
                                             <A
HREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER
>GdkRgbDither</A> dither);</PRE
></TD
></TR
></TABLE
><P
>Set the dithering mode for the display. </P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36612"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>preview</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkpreview.html"
>GtkPreview</A
>.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>dither</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the dithering mode.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36626"
></A
><H3
><A
NAME="GTK-PREVIEW-GET-VISUAL"
></A
>gtk_preview_get_visual ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-visuals.html#GDKVISUAL
>GdkVisual</A>*  gtk_preview_get_visual          (void);</PRE
></TD
></TR
></TABLE
><P
>Returns the visual used by preview widgets. This
function is deprecated, and you should use
<A
HREF=../gdk/gdk-gdkrgb.html#GDK-RGB-GET-VISUAL
>gdk_rgb_get_visual</A>() instead.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36633"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the visual for previews.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36642"
></A
><H3
><A
NAME="GTK-PREVIEW-GET-CMAP"
></A
>gtk_preview_get_cmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP
>GdkColormap</A>* gtk_preview_get_cmap           (void);</PRE
></TD
></TR
></TABLE
><P
>Returns the colormap used by preview widgets. This
function is deprecated, and you should use
<A
HREF=../gdk/gdk-gdkrgb.html#GDK-RGB-GET-CMAP
>gdk_rgb_get_cmap</A>() instead.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36649"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>the colormap for previews.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36658"
></A
><H3
><A
NAME="GTK-PREVIEW-GET-INFO"
></A
>gtk_preview_get_info ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gtkpreview.html#GTKPREVIEWINFO"
>GtkPreviewInfo</A
>* gtk_preview_get_info        (void);</PRE
></TD
></TR
></TABLE
><P
>Return a <A
HREF="gtkpreview.html#GTKPREVIEWINFO"
>GtkPreviewInfo</A
> structure containing 
global information about preview widgets.</P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN36665"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a <A
HREF="gtkpreview.html#GTKPREVIEWINFO"
>GtkPreviewInfo</A
> structure. The return
 value belongs to GTK+ and must not be modified
 or freed.
&#13;</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN36675"
></A
><H3
><A
NAME="GTK-PREVIEW-RESET"
></A
>gtk_preview_reset ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gtk_preview_reset               (void);</PRE
></TD
></TR
></TABLE
><P
>This function is deprecated and does nothing. It was
once used for changing the colormap and visual on the fly.</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN36680"
></A
><H2
>See Also</H2
><P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>GdkRGB</DT
><DD
><P
>the backend used by <A
HREF="gtkpreview.html"
>GtkPreview</A
>.</P
></DD
></DL
></DIV
></P
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gtkplug.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="index.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gtkobjects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gtkprogress.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkPlug</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GtkProgress</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>