| The GtkHTML Library |
|---|
GtkWidget * gtk_html_new (void);GtkWidget * gtk_html_new_from_string (constgchar *str,gint len); void gtk_html_construct (GtkWidget *html); void gtk_html_load_from_string (GtkHTML *html, constgchar *str,gint len);GtkHTMLStream * gtk_html_begin (GtkHTML *html);GtkHTMLStream * gtk_html_begin_content (GtkHTML *html,gchar *content_type); void gtk_html_write (GtkHTML *html,GtkHTMLStream *handle, constgchar *buffer,size_t size); void gtk_html_end (GtkHTML *html,GtkHTMLStream *handle, GtkHTMLStreamStatus status);gboolean gtk_html_save (GtkHTML *html, GtkHTMLSaveReceiverFn receiver,gpointer data);gboolean gtk_html_export (GtkHTML *html, const char *type, GtkHTMLSaveReceiverFn receiver,gpointer data); void gtk_html_print (GtkHTML *html,GnomePrintContext *print_context); void gtk_html_print_with_header_footer (GtkHTML *html,GnomePrintContext *print_context,gdouble header_height,gdouble footer_height, GtkHTMLPrintCallback header_print, GtkHTMLPrintCallback footer_print,gpointer user_data); constgchar * gtk_html_get_title (GtkHTML *html);gboolean gtk_html_jump_to_anchor (GtkHTML *html, constgchar *anchor); void gtk_html_set_default_background_color (GtkHTML *html,GdkColor *c); void gtk_html_set_default_content_type (GtkHTML *html,gchar *content_type); void gtk_html_allow_selection (GtkHTML *html,gboolean allow);gpointer gtk_html_get_object_by_id (GtkHTML *html, constgchar *id);
GtkHTML widget is lightweight HTML viewer / container. It provides an easy way for viewing HTML documents in your application and for layout UI of your application throught HTML.
GtkWidget * gtk_html_new (void);
GtkHTML widget contructor. It creates an empty GtkHTML widget.
| Returns : | A GtkHTML widget, newly created and empty. |
GtkWidget * gtk_html_new_from_string (constgchar *str,gint len);
GtkHTML widget constructor. It creates an new GtkHTML widget and loads HTML source from str.
It is intended for simple creation. For more complicated loading you probably want to use
| str : | A string containing HTML source. |
| len : | A length of str, if len == -1 then it will be computed using strlen. |
| Returns : | A GtkHTML widget, newly created, containing document loaded from input str. |
void gtk_html_load_from_string (GtkHTML *html, constgchar *str,gint len);
| html : | |
| str : | |
| len : |
|
GtkHTMLStream * gtk_html_begin (GtkHTML *html);
Opens a new stream to load new content into the GtkHTML widget html.
| html : | the html widget to operate on. |
| Returns : | a new GtkHTMLStream to store new content. |
GtkHTMLStream * gtk_html_begin_content (GtkHTML *html,gchar *content_type);
Opens a new stream to load new content of type content_type into the GtkHTML widget given in html.
| html : | the html widget to operate on. |
| content_type : | a string listing the type of content to expect on the stream. |
| Returns : | a new GtkHTMLStream to store new content. |
void gtk_html_write (GtkHTML *html,GtkHTMLStream *handle, constgchar *buffer,size_t size);
Writes size bytes of buffer to the stream pointed to by stream.
| html : | the GtkHTML widget the stream belongs to (unused) |
| handle : | the GkHTMLStream to write to. |
| buffer : | the data to write to the stream. |
| size : | the length of data to read from buffer |
void gtk_html_end (GtkHTML *html,GtkHTMLStream *handle, GtkHTMLStreamStatus status);
Close the GtkHTMLStream represented by stream and notify html that is should not expect any more content from that stream.
| html : | the GtkHTML widget the stream belongs to. |
| handle : | the GtkHTMLStream to close. |
| status : | the GtkHTMLStreamStatus representing the state of the stream when closed. |
gboolean gtk_html_save (GtkHTML *html, GtkHTMLSaveReceiverFn receiver,gpointer data);
| html : | |
| receiver : | |
| data : | |
| Returns : |
|
gboolean gtk_html_export (GtkHTML *html, const char *type, GtkHTMLSaveReceiverFn receiver,gpointer data);
Export the current document into the content type given by content_type, by calling the function listed in receiver data becomes avaiable. When receiver is called user_data is passed in as the user_data parameter.
| html : | the GtkHTML widget |
| type : | |
| receiver : |
|
| data : | |
| Returns : | TRUE if the export was successfull, FALSE otherwise. |
void gtk_html_print (GtkHTML *html,GnomePrintContext *print_context);
| html : | |
| print_context : |
|
void gtk_html_print_with_header_footer
(GtkHTML *html,
GnomePrintContext *print_context,
gdouble header_height,
gdouble footer_height,
GtkHTMLPrintCallback header_print,
GtkHTMLPrintCallback footer_print,
gpointer user_data);| html : | |
| print_context : | |
| header_height : | |
| footer_height : | |
| header_print : | |
| footer_print : | |
| user_data : |
|
constgchar * gtk_html_get_title (GtkHTML *html);
Retrieve the title of the document currently loaded in the GtkHTML widget.
| html : | The GtkHTML widget. |
| Returns : | the title of the current document |
gboolean gtk_html_jump_to_anchor (GtkHTML *html, constgchar *anchor);
Scroll the document display to show the HTML anchor listed in anchor
| html : | the GtkHTML widget. |
| anchor : | a string containing the name of the anchor. |
| Returns : | TRUE if the anchor is found, FALSE otherwise. |
void gtk_html_set_default_background_color
(GtkHTML *html,
GdkColor *c);| html : | |
| c : |
|
void gtk_html_set_default_content_type
(GtkHTML *html,
gchar *content_type);| html : | |
| content_type : |
|
void gtk_html_allow_selection (GtkHTML *html,gboolean allow);
| html : | |
| allow : |
|
| <<< API Reference | GtkHTMLEmbedded widget >>> |