forked from AuroraMiddleware/gtk
cc6b34c1e3
2001-05-11 Havoc Pennington <hp@pobox.com> * gtk/gtkimage.c (gtk_image_new_from_stock): docs, fixes bug #54144 * gtk/gtkcolorsel.c (gtk_color_selection_new): docs, fixes bug #54330 2001-05-11 Havoc Pennington <hp@pobox.com> * gtk/tmpl/gtkvruler.sgml, gtk/tmpl/gtkhruler.sgml: fix bug #54431 * gtk/tmpl/gtkdrawingarea.sgml: fix bug #54331 * gtk/tmpl/gtkenums.sgml: fix bug #54329, and update some other random things * gtk/gtk-sections.txt: updates * gtk/tmpl/gtkmenuitem.sgml: fix bug #54277 * gtk/tmpl/gtkradiomenuitem.sgml: fix bug #54323, #54324, #54325
280 lines
4.2 KiB
Plaintext
280 lines
4.2 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkImage
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A widget displaying a graphical image
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkImage widget displays a graphical image. The image is typically created
|
|
using gdk_image_new.
|
|
</para>
|
|
<para>
|
|
The pixels in a #GtkImage may be manipulated by the application after creation,
|
|
as #GtkImage store the pixel data on the client side. If you wish to store the
|
|
pixel data on the server side (thus not allowing manipulation of the data after
|
|
creation) you should use #GtkPixmap.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkPixmap, #GdkRgb
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkImage ##### -->
|
|
<para>
|
|
This struct contain private data only and should be accessed by the functions
|
|
below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### ENUM GtkImageType ##### -->
|
|
<para>
|
|
Describes the representation stored by a #GtkImage. If you want to get the image
|
|
from the widget, you can only get the currently-stored representation. e.g. if
|
|
the gtk_image_get_storage_type() returns #GTK_IMAGE_PIXBUF, then you can call
|
|
gtk_image_get_pixbuf() but not gtk_image_get_stock(). For empty images, you can
|
|
request any storage type (call any of the "get" functions), but they will all
|
|
return %NULL values.
|
|
</para>
|
|
|
|
@GTK_IMAGE_EMPTY: there is no image displayed by the widget
|
|
@GTK_IMAGE_PIXMAP: the widget contains a #GdkPixmap
|
|
@GTK_IMAGE_IMAGE: the widget contains a #GdkImage
|
|
@GTK_IMAGE_PIXBUF: the widget contains a #GdkPixbuf
|
|
@GTK_IMAGE_STOCK: the widget contains a stock icon name
|
|
@GTK_IMAGE_ICON_SET: the widget contains a #GtkIconSet
|
|
@GTK_IMAGE_ANIMATION:
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@icon_set:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@gdk_image:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@stock_id:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get_storage_type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_file ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@filename:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@icon_set:
|
|
@size:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pixbuf:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@pixmap:
|
|
@mask:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@stock_id:
|
|
@size:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new_from_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@animation:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_file ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@filename:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_icon_set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@icon_set:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_image ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@gdk_image:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_pixbuf ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixbuf:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_pixmap ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@pixmap:
|
|
@mask:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_stock ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@stock_id:
|
|
@size:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set_from_animation ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@image:
|
|
@animation:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_new ##### -->
|
|
<para>
|
|
Creates the new GtkImage using the value and the mask.
|
|
</para>
|
|
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
@Returns: the GtkImage
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_set ##### -->
|
|
<para>
|
|
Sets the GtkImage
|
|
</para>
|
|
|
|
@image: a #GdkPixmap
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_image_get ##### -->
|
|
<para>
|
|
Gets the GtkImage
|
|
</para>
|
|
|
|
@image: a #GdkPixmap
|
|
@val:
|
|
@mask: a GDKBitmap that indicates which parts of the image should be transparent.
|
|
|
|
|