diff options
Diffstat (limited to 'gtk+-mingw/share/gtk-doc/html/gtk3/GtkLabel.html')
| -rw-r--r-- | gtk+-mingw/share/gtk-doc/html/gtk3/GtkLabel.html | 2061 |
1 files changed, 0 insertions, 2061 deletions
diff --git a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkLabel.html b/gtk+-mingw/share/gtk-doc/html/gtk3/GtkLabel.html deleted file mode 100644 index 6bf5b98..0000000 --- a/gtk+-mingw/share/gtk-doc/html/gtk3/GtkLabel.html +++ /dev/null @@ -1,2061 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> -<title>GtkLabel</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.76.1"> -<link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> -<link rel="up" href="DisplayWidgets.html" title="Display Widgets"> -<link rel="prev" href="GtkImage.html" title="GtkImage"> -<link rel="next" href="GtkProgressBar.html" title="GtkProgressBar"> -<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)"> -<link rel="stylesheet" href="style.css" type="text/css"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"> -<tr valign="middle"> -<td><a accesskey="p" href="GtkImage.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> -<td><a accesskey="u" href="DisplayWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> -<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> -<th width="100%" align="center">GTK+ 3 Reference Manual</th> -<td><a accesskey="n" href="GtkProgressBar.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> -</tr> -<tr><td colspan="5" class="shortcuts"> -<a href="#GtkLabel.synopsis" class="shortcut">Top</a> - | - <a href="#GtkLabel.description" class="shortcut">Description</a> - | - <a href="#GtkLabel.object-hierarchy" class="shortcut">Object Hierarchy</a> - | - <a href="#GtkLabel.implemented-interfaces" class="shortcut">Implemented Interfaces</a> - | - <a href="#GtkLabel.properties" class="shortcut">Properties</a> - | - <a href="#GtkLabel.signals" class="shortcut">Signals</a> -</td></tr> -</table> -<div class="refentry"> -<a name="GtkLabel"></a><div class="titlepage"></div> -<div class="refnamediv"><table width="100%"><tr> -<td valign="top"> -<h2><span class="refentrytitle"><a name="GtkLabel.top_of_page"></a>GtkLabel</span></h2> -<p>GtkLabel — A widget that displays a small to medium amount of text</p> -</td> -<td valign="top" align="right"><img src="label.png"></td> -</tr></table></div> -<div class="refsynopsisdiv"> -<a name="GtkLabel.synopsis"></a><h2>Synopsis</h2> -<pre class="synopsis"> -#include <gtk/gtk.h> - -struct <a class="link" href="GtkLabel.html#GtkLabel-struct" title="struct GtkLabel">GtkLabel</a>; -<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkLabel.html#gtk-label-new" title="gtk_label_new ()">gtk_label_new</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-text" title="gtk_label_set_text ()">gtk_label_set_text</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()">gtk_label_set_attributes</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()">gtk_label_set_markup</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-markup-with-mnemonic" title="gtk_label_set_markup_with_mnemonic ()">gtk_label_set_markup_with_mnemonic</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-pattern" title="gtk_label_set_pattern ()">gtk_label_set_pattern</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-justify" title="gtk_label_set_justify ()">gtk_label_set_justify</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> jtype</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-ellipsize" title="gtk_label_set_ellipsize ()">gtk_label_set_ellipsize</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> mode</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()">gtk_label_set_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-max-width-chars" title="gtk_label_set_max_width_chars ()">gtk_label_set_max_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()">gtk_label_set_line_wrap</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap-mode" title="gtk_label_set_line_wrap_mode ()">gtk_label_set_line_wrap_mode</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> wrap_mode</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-get-layout-offsets" title="gtk_label_get_layout_offsets ()">gtk_label_get_layout_offsets</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-mnemonic-keyval" title="gtk_label_get_mnemonic_keyval ()">gtk_label_get_mnemonic_keyval</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-selectable" title="gtk_label_get_selectable ()">gtk_label_get_selectable</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-text" title="gtk_label_get_text ()">gtk_label_get_text</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()">gtk_label_new_with_mnemonic</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-select-region" title="gtk_label_select_region ()">gtk_label_select_region</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()">gtk_label_set_mnemonic_widget</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()">gtk_label_set_selectable</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-text-with-mnemonic" title="gtk_label_set_text_with_mnemonic ()">gtk_label_set_text_with_mnemonic</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-attributes" title="gtk_label_get_attributes ()">gtk_label_get_attributes</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="returnvalue">GtkJustification</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-justify" title="gtk_label_get_justify ()">gtk_label_get_justify</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="returnvalue">PangoEllipsizeMode</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-ellipsize" title="gtk_label_get_ellipsize ()">gtk_label_get_ellipsize</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-width-chars" title="gtk_label_get_width_chars ()">gtk_label_get_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-max-width-chars" title="gtk_label_get_max_width_chars ()">gtk_label_get_max_width_chars</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-label" title="gtk_label_get_label ()">gtk_label_get_label</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-layout" title="gtk_label_get_layout ()">gtk_label_get_layout</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-line-wrap" title="gtk_label_get_line_wrap ()">gtk_label_get_line_wrap</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="returnvalue">PangoWrapMode</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-line-wrap-mode" title="gtk_label_get_line_wrap_mode ()">gtk_label_get_line_wrap_mode</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-mnemonic-widget" title="gtk_label_get_mnemonic_widget ()">gtk_label_get_mnemonic_widget</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-selection-bounds" title="gtk_label_get_selection_bounds ()">gtk_label_get_selection_bounds</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-use-markup" title="gtk_label_get_use_markup ()">gtk_label_get_use_markup</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-use-underline" title="gtk_label_get_use_underline ()">gtk_label_get_use_underline</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-single-line-mode" title="gtk_label_get_single_line_mode ()">gtk_label_get_single_line_mode</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-angle" title="gtk_label_get_angle ()">gtk_label_get_angle</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-label" title="gtk_label_set_label ()">gtk_label_set_label</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-use-markup" title="gtk_label_set_use_markup ()">gtk_label_set_use_markup</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-use-underline" title="gtk_label_set_use_underline ()">gtk_label_set_use_underline</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-single-line-mode" title="gtk_label_set_single_line_mode ()">gtk_label_set_single_line_mode</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-angle" title="gtk_label_set_angle ()">gtk_label_set_angle</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>); -const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkLabel.html#gtk-label-get-current-uri" title="gtk_label_get_current_uri ()">gtk_label_get_current_uri</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -<span class="returnvalue">void</span> <a class="link" href="GtkLabel.html#gtk-label-set-track-visited-links" title="gtk_label_set_track_visited_links ()">gtk_label_set_track_visited_links</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>); -<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkLabel.html#gtk-label-get-track-visited-links" title="gtk_label_get_track_visited_links ()">gtk_label_get_track_visited_links</a> (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>); -</pre> -</div> -<div class="refsect1"> -<a name="GtkLabel.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="synopsis"> - <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> - +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> - +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> - +----<a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a> - +----GtkLabel - +----<a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel">GtkAccelLabel</a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkLabel.implemented-interfaces"></a><h2>Implemented Interfaces</h2> -<p> -GtkLabel implements - AtkImplementorIface and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p> -</div> -<div class="refsect1"> -<a name="GtkLabel.properties"></a><h2>Properties</h2> -<pre class="synopsis"> - "<a class="link" href="GtkLabel.html#GtkLabel--angle" title='The "angle" property'>angle</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--attributes" title='The "attributes" property'>attributes</a>" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>* : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--cursor-position" title='The "cursor-position" property'>cursor-position</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read - "<a class="link" href="GtkLabel.html#GtkLabel--ellipsize" title='The "ellipsize" property'>ellipsize</a>" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--justify" title='The "justify" property'>justify</a>" <a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--label" title='The "label" property'>label</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'>max-width-chars</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-keyval" title='The "mnemonic-keyval" property'>mnemonic-keyval</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read - "<a class="link" href="GtkLabel.html#GtkLabel--mnemonic-widget" title='The "mnemonic-widget" property'>mnemonic-widget</a>" <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>* : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--pattern" title='The "pattern" property'>pattern</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Write - "<a class="link" href="GtkLabel.html#GtkLabel--selectable" title='The "selectable" property'>selectable</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--selection-bound" title='The "selection-bound" property'>selection-bound</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read - "<a class="link" href="GtkLabel.html#GtkLabel--single-line-mode" title='The "single-line-mode" property'>single-line-mode</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--track-visited-links" title='The "track-visited-links" property'>track-visited-links</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'>use-markup</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'>use-underline</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'>width-chars</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'>wrap</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write - "<a class="link" href="GtkLabel.html#GtkLabel--wrap-mode" title='The "wrap-mode" property'>wrap-mode</a>" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> : Read / Write -</pre> -</div> -<div class="refsect1"> -<a name="GtkLabel.signals"></a><h2>Signals</h2> -<pre class="synopsis"> - "<a class="link" href="GtkLabel.html#GtkLabel-activate-current-link" title='The "activate-current-link" signal'>activate-current-link</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkLabel.html#GtkLabel-activate-link" title='The "activate-link" signal'>activate-link</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> - "<a class="link" href="GtkLabel.html#GtkLabel-copy-clipboard" title='The "copy-clipboard" signal'>copy-clipboard</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkLabel.html#GtkLabel-move-cursor" title='The "move-cursor" signal'>move-cursor</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a> - "<a class="link" href="GtkLabel.html#GtkLabel-populate-popup" title='The "populate-popup" signal'>populate-popup</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a> -</pre> -</div> -<div class="refsect1"> -<a name="GtkLabel.description"></a><h2>Description</h2> -<p> -The <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget displays a small amount of text. As the name -implies, most labels are used to label another widget such as a -<a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>, a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a>, or a <a href="http://library.gnome.org/devel/gtk3/GtkOptionMenu.html"><span class="type">GtkOptionMenu</span></a>. -</p> -<p> -</p> -<div class="refsect2"> -<a name="GtkLabel-BUILDER-UI"></a><h3>GtkLabel as GtkBuildable</h3> -<p> -The GtkLabel implementation of the GtkBuildable interface supports a -custom <attributes> element, which supports any number of <attribute> -elements. the <attribute> element has attributes named name, value, -start and end and allows you to specify <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> values for this label. -</p> -<p> -</p> -<div class="example"> -<a name="id761697"></a><p class="title"><b>Example 51. A UI definition fragment specifying Pango attributes</b></p> -<div class="example-contents"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5 -6</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="symbol">></span> -<span class="normal"> </span><span class="symbol"><</span><span class="normal">attributes</span><span class="symbol">></span> -<span class="normal"> </span><span class="symbol"><</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"weight"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"PANGO_WEIGHT_BOLD"</span><span class="symbol">/></span> -<span class="normal"> </span><span class="symbol"><</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"background"</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">"red"</span><span class="normal"> start</span><span class="symbol">=</span><span class="string">"5"</span><span class="normal"> end</span><span class="symbol">=</span><span class="string">"10"</span><span class="symbol">/></span><span class="string">"</span> -<span class="string"> </attributes></span> -<span class="string"></object></span></pre></td> - </tr> - </tbody> - </table> -</div> - -</div> -<p><br class="example-break"> -The start and end attributes specify the range of characters to which the -Pango attribute applies. If start and end are not specified, the attribute is -applied to the whole text. Note that specifying ranges does not make much -sense with translatable attributes. Use markup embedded in the translatable -content instead. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id761717"></a><h3>Mnemonics</h3> -<p> -Labels may contain <em class="firstterm">mnemonics</em>. Mnemonics are -underlined characters in the label, used for keyboard navigation. -Mnemonics are created by providing a string with an underscore before -the mnemonic character, such as <code class="literal">"_File"</code>, to the -functions <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()"><code class="function">gtk_label_new_with_mnemonic()</code></a> or -<a class="link" href="GtkLabel.html#gtk-label-set-text-with-mnemonic" title="gtk_label_set_text_with_mnemonic ()"><code class="function">gtk_label_set_text_with_mnemonic()</code></a>. -</p> -<p> -Mnemonics automatically activate any activatable widget the label is -inside, such as a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>; if the label is not inside the -mnemonic's target widget, you have to tell the label about the target -using <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>. Here's a simple example where -the label is inside a button: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="comment">// Pressing Alt+H will activate this button</span> -<span class="normal">button </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkButton.html#gtk-button-new">gtk_button_new</a></span><span class="normal"> </span><span class="symbol">();</span> -<span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new-with-mnemonic">gtk_label_new_with_mnemonic</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"_Hello"</span><span class="symbol">);</span> -<span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">),</span><span class="normal"> label</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -There's a convenience function to create buttons with a mnemonic label -already inside: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="comment">// Pressing Alt+H will activate this button</span> -<span class="normal">button </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkButton.html#gtk-button-new-with-mnemonic">gtk_button_new_with_mnemonic</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"_Hello"</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -To create a mnemonic for a widget alongside the label, such as a -<a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>, you have to point the label at the entry with -<a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="comment">// Pressing Alt+H will focus the entry</span> -<span class="normal">entry </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkEntry.html#gtk-entry-new">gtk_entry_new</a></span><span class="normal"> </span><span class="symbol">();</span> -<span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new-with-mnemonic">gtk_label_new_with_mnemonic</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"_Hello"</span><span class="symbol">);</span> -<span class="function"><a href="GtkLabel.html#gtk-label-set-mnemonic-widget">gtk_label_set_mnemonic_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> entry</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id761857"></a><h3>Markup (styled text)</h3> -<p> -To make it easy to format text in a label (changing colors, fonts, -etc.), label text can be provided in a simple <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">markup format</a>. -Here's how to create a label with a small font: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="normal">label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span> -<span class="function"><a href="GtkLabel.html#gtk-label-set-markup">gtk_label_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> </span><span class="string">"<span style="</span><span class="normal">color</span><span class="symbol">:</span><span class="normal"> red</span><span class="string">"><small>Small text</small></span>"</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -(See <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">complete documentation</a> of available -tags in the Pango manual.) -</p> -<p> -The markup passed to <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a> must be valid; for example, -literal <, > and & characters must be escaped as \<, -\gt;, and \&. If you pass text obtained from the user, file, -or a network to <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>, you'll want to escape it with -<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>. -</p> -<p> -Markup strings are just a convenient way to set the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> on -a label; <a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()"><code class="function">gtk_label_set_attributes()</code></a> may be a simpler way to set -attributes in some cases. Be careful though; <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> tends to -cause internationalization problems, unless you're applying attributes -to the entire string (i.e. unless you set the range of each attribute -to [0, <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#G-MAXINT:CAPS"><code class="literal">G_MAXINT</code></a>)). The reason is that specifying the start_index and -end_index for a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttribute"><span class="type">PangoAttribute</span></a> requires knowledge of the exact string -being displayed, so translations will cause problems. -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id761994"></a><h3>Selectable labels</h3> -Labels can be made selectable with <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>. -Selectable labels allow the user to copy the label contents to -the clipboard. Only labels that contain useful-to-copy information -— such as error messages — should be made selectable. -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="label-text-layout"></a><h3>Text layout</h3> -<p> -A label can contain any number of paragraphs, but will have -performance problems if it contains more than a small number. -Paragraphs are separated by newlines or other paragraph separators -understood by Pango. -</p> -<p> -Labels can automatically wrap text if you call -<a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()"><code class="function">gtk_label_set_line_wrap()</code></a>. -</p> -<p> -<a class="link" href="GtkLabel.html#gtk-label-set-justify" title="gtk_label_set_justify ()"><code class="function">gtk_label_set_justify()</code></a> sets how the lines in a label align -with one another. If you want to set how the label as a whole -aligns in its available space, see <a class="link" href="GtkMisc.html#gtk-misc-set-alignment" title="gtk_misc_set_alignment ()"><code class="function">gtk_misc_set_alignment()</code></a>. -</p> -<p> -The <a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'><span class="type">"width-chars"</span></a> and <a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'><span class="type">"max-width-chars"</span></a> properties -can be used to control the size allocation of ellipsized or wrapped -labels. For ellipsizing labels, if either is specified (and less -than the actual text size), it is used as the minimum width, and the actual -text size is used as the natural width of the label. For wrapping labels, -width-chars is used as the minimum width, if specified, and max-width-chars -is used as the natural width. Even if max-width-chars specified, wrapping -labels will be rewrapped to use all of the available width. -</p> -<p> -</p> -<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Note</h3> -<p> -Note that the interpretation of <a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'><span class="type">"width-chars"</span></a> and -<a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'><span class="type">"max-width-chars"</span></a> has changed a bit with the introduction of -<a class="link" href="GtkWidget.html#geometry-management" title="Height-for-width Geometry Management">width-for-height geometry management.</a> -</p> -</div> -<p> -</p> -</div> -<p> -</p> -<hr> -<div class="refsect2"> -<a name="id762118"></a><h3>Links</h3> -<p> -Since 2.18, GTK+ supports markup for clickable hyperlinks in addition -to regular Pango markup. The markup for links is borrowed from HTML, using the -<code class="sgmltag-element">a</code> with href and title attributes. GTK+ renders links similar to the -way they appear in web browsers, with colored, underlined text. The title -attribute is displayed as a tooltip on the link. An example looks like this: -</p> -<p> -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="function"><a href="GtkLabel.html#gtk-label-set-markup">gtk_label_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Go to the <span style="</span><span class="normal">color</span><span class="symbol">:</span><span class="normal"> red</span><span class="string">"><a>GTK+ website</a></span> for more..."</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<p> -It is possible to implement custom handling for links and their tooltips with -the <a class="link" href="GtkLabel.html#GtkLabel-activate-link" title='The "activate-link" signal'><span class="type">"activate-link"</span></a> signal and the <a class="link" href="GtkLabel.html#gtk-label-get-current-uri" title="gtk_label_get_current_uri ()"><code class="function">gtk_label_get_current_uri()</code></a> function. -</p> -</div> -<p> -</p> -</div> -<div class="refsect1"> -<a name="GtkLabel.details"></a><h2>Details</h2> -<div class="refsect2"> -<a name="GtkLabel-struct"></a><h3>struct GtkLabel</h3> -<pre class="programlisting">struct GtkLabel;</pre> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-new"></a><h3>gtk_label_new ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_label_new (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Creates a new label with the given text inside it. You can -pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to get an empty label widget. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>The text of the label</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the new <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-text"></a><h3>gtk_label_set_text ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_text (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Sets the text within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. It overwrites any text that -was there before. -</p> -<p> -This will also clear any previously set mnemonic accelerators. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>The text you want to set</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-attributes"></a><h3>gtk_label_set_attributes ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_attributes (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> *attrs</code></em>);</pre> -<p> -Sets a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>; the attributes in the list are applied to the -label text. -</p> -<p> -</p> -<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> -<h3 class="title">Note</h3> -<p>The attributes set with this function will be applied -and merged with any other attributes previously effected by way -of the <a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'><span class="type">"use-underline"</span></a> or <a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'><span class="type">"use-markup"</span></a> properties. -While it is not recommended to mix markup strings with manually set -attributes, if you must; know that the attributes will be applied -to the label after the markup string is parsed.</p> -</div> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td> -<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-markup"></a><h3>gtk_label_set_markup ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_markup (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Parses <em class="parameter"><code>str</code></em> which is marked up with the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>, setting the -label's text and attribute list based on the parse results. If the <em class="parameter"><code>str</code></em> is -external data, you may need to escape it with <a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-escape-text"><code class="function">g_markup_escape_text()</code></a> or -<a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"><code class="function">g_markup_printf_escaped()</code></a>: -</p> -<div class="informalexample"> - <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> - <tbody> - <tr> - <td class="listing_lines" align="right"><pre>1 -2 -3 -4 -5</pre></td> - <td class="listing_code"><pre class="programlisting"><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">markup</span><span class="symbol">;</span> - -<span class="normal">markup </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped">g_markup_printf_escaped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"<span style=</span><span class="specialchar">\"</span><span class="string">italic</span><span class="specialchar">\"</span><span class="string">>%s</span>"</span><span class="symbol">,</span><span class="normal"> str</span><span class="symbol">);</span> -<span class="function"><a href="GtkLabel.html#gtk-label-set-markup">gtk_label_set_markup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_LABEL</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">label</span><span class="symbol">),</span><span class="normal"> markup</span><span class="symbol">);</span> -<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">markup</span><span class="symbol">);</span></pre></td> - </tr> - </tbody> - </table> -</div> - -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>a markup string (see <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-markup-with-mnemonic"></a><h3>gtk_label_set_markup_with_mnemonic ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_markup_with_mnemonic (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Parses <em class="parameter"><code>str</code></em> which is marked up with the -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango text markup language</a>, -setting the label's text and attribute list based on the parse results. -If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are underlined -indicating that they represent a keyboard accelerator called a mnemonic. -</p> -<p> -The mnemonic key can be used to activate another widget, chosen -automatically, or explicitly using <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>a markup string (see -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/PangoMarkupFormat.html">Pango markup format</a>)</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-pattern"></a><h3>gtk_label_set_pattern ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_pattern (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);</pre> -<p> -The pattern of underlines you want under the existing text within the -<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. For example if the current text of the label says -"FooBarBaz" passing a pattern of "___ ___" will underline -"Foo" and "Baz" but not "Bar". -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>The <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> you want to set the pattern to.</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td> -<td>The pattern as described above.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-justify"></a><h3>gtk_label_set_justify ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_justify (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> jtype</code></em>);</pre> -<p> -Sets the alignment of the lines in the text of the label relative to -each other. <a class="link" href="gtk3-Standard-Enumerations.html#GTK-JUSTIFY-LEFT:CAPS"><code class="literal">GTK_JUSTIFY_LEFT</code></a> is the default value when the -widget is first created with <a class="link" href="GtkLabel.html#gtk-label-new" title="gtk_label_new ()"><code class="function">gtk_label_new()</code></a>. If you instead want -to set the alignment of the label as a whole, use -<a class="link" href="GtkMisc.html#gtk-misc-set-alignment" title="gtk_misc_set_alignment ()"><code class="function">gtk_misc_set_alignment()</code></a> instead. <a class="link" href="GtkLabel.html#gtk-label-set-justify" title="gtk_label_set_justify ()"><code class="function">gtk_label_set_justify()</code></a> has no -effect on labels containing only a single line. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>jtype</code></em> :</span></p></td> -<td>a <a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-ellipsize"></a><h3>gtk_label_set_ellipsize ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_ellipsize (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> mode</code></em>);</pre> -<p> -Sets the mode used to ellipsize (add an ellipsis: "...") to the text -if there is not enough space to render the entire string. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td> -<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> -</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-width-chars"></a><h3>gtk_label_set_width_chars ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_width_chars (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre> -<p> -Sets the desired width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_chars</code></em> :</span></p></td> -<td>the new desired width, in characters.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-max-width-chars"></a><h3>gtk_label_set_max_width_chars ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_max_width_chars (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_chars</code></em>);</pre> -<p> -Sets the desired maximum width in characters of <em class="parameter"><code>label</code></em> to <em class="parameter"><code>n_chars</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>n_chars</code></em> :</span></p></td> -<td>the new desired maximum width, in characters.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-line-wrap"></a><h3>gtk_label_set_line_wrap ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_line_wrap (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap</code></em>);</pre> -<p> -Toggles line wrapping within the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> makes it break -lines if text exceeds the widget's size. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> lets the text get cut off -by the edge of the widget if it exceeds the widget size. -</p> -<p> -Note that setting line wrapping to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> does not make the label -wrap at its parent container's width, because GTK+ widgets -conceptually can't make their requisition depend on the parent -container's size. For a label that wraps at a specific position, -set the label's width using <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>wrap</code></em> :</span></p></td> -<td>the setting</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-line-wrap-mode"></a><h3>gtk_label_set_line_wrap_mode ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_line_wrap_mode (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> wrap_mode</code></em>);</pre> -<p> -If line wrapping is on (see <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()"><code class="function">gtk_label_set_line_wrap()</code></a>) this controls how -the line wrapping is done. The default is <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-WRAP-WORD:CAPS"><code class="literal">PANGO_WRAP_WORD</code></a> which means -wrap on word boundaries. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>wrap_mode</code></em> :</span></p></td> -<td>the line wrapping mode</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-layout-offsets"></a><h3>gtk_label_get_layout_offsets ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_get_layout_offsets (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre> -<p> -Obtains the coordinates where the label will draw the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> -representing the text in the label; useful to convert mouse events -into coordinates inside the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a>, e.g. to take some action -if some part of the label is clicked. Of course you will need to -create a <a class="link" href="GtkEventBox.html" title="GtkEventBox"><span class="type">GtkEventBox</span></a> to receive the events, and pack the label -inside it, since labels are a <a href="http://library.gnome.org/devel/gtk3/GtkWidget.html#GTK-NO-WINDOW:CAPS"><span class="type">GTK_NO_WINDOW</span></a> widget. Remember -when using the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> functions you need to convert to -and from pixels using <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"><code class="function">PANGO_PIXELS()</code></a> or <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><span class="type">PANGO_SCALE</span></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td> -<td>location to store X offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td> -<td>location to store Y offset of layout, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-mnemonic-keyval"></a><h3>gtk_label_get_mnemonic_keyval ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> gtk_label_get_mnemonic_keyval (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -If the label has been set so that it has an mnemonic key this function -returns the keyval used for the mnemonic accelerator. If there is no -mnemonic set up it returns <span class="type">GDK_VoidSymbol</span>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>GDK keyval usable for accelerators, or <span class="type">GDK_VoidSymbol</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-selectable"></a><h3>gtk_label_get_selectable ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_selectable (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Gets the value set by <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user can copy text from the label</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-text"></a><h3>gtk_label_get_text ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_label_get_text (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Fetches the text from a label widget, as displayed on the -screen. This does not include any embedded underlines -indicating mnemonics or Pango markup. (See <a class="link" href="GtkLabel.html#gtk-label-get-label" title="gtk_label_get_label ()"><code class="function">gtk_label_get_label()</code></a>) -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the text in the label widget. This is the internal -string used by the label, and must not be modified.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-new-with-mnemonic"></a><h3>gtk_label_new_with_mnemonic ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_label_new_with_mnemonic (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Creates a new <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a>, containing the text in <em class="parameter"><code>str</code></em>. -</p> -<p> -If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are -underlined. If you need a literal underscore character in a label, use -'__' (two underscores). The first underlined character represents a -keyboard accelerator called a mnemonic. The mnemonic key can be used -to activate another widget, chosen automatically, or explicitly using -<a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>. -</p> -<p> -If <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a> is not called, then the first -activatable ancestor of the <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> will be chosen as the mnemonic -widget. For instance, if the label is inside a button or menu item, -the button or menu item will automatically become the mnemonic widget -and be activated by the mnemonic. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>The text of the label, with an underscore in front of the -mnemonic character</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the new <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-select-region"></a><h3>gtk_label_select_region ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_select_region (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> start_offset</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> end_offset</code></em>);</pre> -<p> -Selects a range of characters in the label, if the label is selectable. -See <a class="link" href="GtkLabel.html#gtk-label-set-selectable" title="gtk_label_set_selectable ()"><code class="function">gtk_label_set_selectable()</code></a>. If the label is not selectable, -this function has no effect. If <em class="parameter"><code>start_offset</code></em> or -<em class="parameter"><code>end_offset</code></em> are -1, then the end of the label will be substituted. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>start_offset</code></em> :</span></p></td> -<td>start offset (in characters not bytes)</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>end_offset</code></em> :</span></p></td> -<td>end offset (in characters not bytes)</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-mnemonic-widget"></a><h3>gtk_label_set_mnemonic_widget ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_mnemonic_widget (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre> -<p> -If the label has been set so that it has an mnemonic key (using -i.e. <a class="link" href="GtkLabel.html#gtk-label-set-markup-with-mnemonic" title="gtk_label_set_markup_with_mnemonic ()"><code class="function">gtk_label_set_markup_with_mnemonic()</code></a>, -<a class="link" href="GtkLabel.html#gtk-label-set-text-with-mnemonic" title="gtk_label_set_text_with_mnemonic ()"><code class="function">gtk_label_set_text_with_mnemonic()</code></a>, <a class="link" href="GtkLabel.html#gtk-label-new-with-mnemonic" title="gtk_label_new_with_mnemonic ()"><code class="function">gtk_label_new_with_mnemonic()</code></a> -or the "use_underline" property) the label can be associated with a -widget that is the target of the mnemonic. When the label is inside -a widget (like a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a> or a <a class="link" href="GtkNotebook.html" title="GtkNotebook"><span class="type">GtkNotebook</span></a> tab) it is -automatically associated with the correct widget, but sometimes -(i.e. when the target is a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> next to the label) you need to -set it explicitly using this function. -</p> -<p> -The target widget will be accelerated by emitting the -GtkWidget::mnemonic-activate signal on it. The default handler for -this signal will activate the widget if there are no mnemonic collisions -and toggle focus between the colliding widgets otherwise. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td> -<td>the target <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-selectable"></a><h3>gtk_label_set_selectable ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_selectable (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -Selectable labels allow the user to select text from the label, for -copy-and-paste. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to allow selecting text in the label</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-text-with-mnemonic"></a><h3>gtk_label_set_text_with_mnemonic ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_text_with_mnemonic (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Sets the label's text from the string <em class="parameter"><code>str</code></em>. -If characters in <em class="parameter"><code>str</code></em> are preceded by an underscore, they are underlined -indicating that they represent a keyboard accelerator called a mnemonic. -The mnemonic key can be used to activate another widget, chosen -automatically, or explicitly using <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>a string</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-attributes"></a><h3>gtk_label_get_attributes ()</h3> -<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="returnvalue">PangoAttrList</span></a> * gtk_label_get_attributes (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Gets the attribute list that was set on the label using -<a class="link" href="GtkLabel.html#gtk-label-set-attributes" title="gtk_label_set_attributes ()"><code class="function">gtk_label_set_attributes()</code></a>, if any. This function does -not reflect attributes that come from the labels markup -(see <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>). If you want to get the -effective attributes for the label, use -pango_layout_get_attribute (gtk_label_get_layout (label)). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the attribute list, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> -if none was set. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-justify"></a><h3>gtk_label_get_justify ()</h3> -<pre class="programlisting"><a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="returnvalue">GtkJustification</span></a> gtk_label_get_justify (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns the justification of the label. See <a class="link" href="GtkLabel.html#gtk-label-set-justify" title="gtk_label_set_justify ()"><code class="function">gtk_label_set_justify()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td><a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a></td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-ellipsize"></a><h3>gtk_label_get_ellipsize ()</h3> -<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="returnvalue">PangoEllipsizeMode</span></a> gtk_label_get_ellipsize (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns the ellipsizing position of the label. See <a class="link" href="GtkLabel.html#gtk-label-set-ellipsize" title="gtk_label_set_ellipsize ()"><code class="function">gtk_label_set_ellipsize()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a></td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-width-chars"></a><h3>gtk_label_get_width_chars ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_label_get_width_chars (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Retrieves the desired width of <em class="parameter"><code>label</code></em>, in characters. See -<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the width of the label in characters.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-max-width-chars"></a><h3>gtk_label_get_max_width_chars ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> gtk_label_get_max_width_chars (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Retrieves the desired maximum width of <em class="parameter"><code>label</code></em>, in characters. See -<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the maximum width of the label in characters.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-label"></a><h3>gtk_label_get_label ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_label_get_label (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Fetches the text from a label widget including any embedded -underlines indicating mnemonics and Pango markup. (See -<a class="link" href="GtkLabel.html#gtk-label-get-text" title="gtk_label_get_text ()"><code class="function">gtk_label_get_text()</code></a>). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the text of the label widget. This string is -owned by the widget and must not be modified or freed.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-layout"></a><h3>gtk_label_get_layout ()</h3> -<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="returnvalue">PangoLayout</span></a> * gtk_label_get_layout (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Gets the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> used to display the label. -The layout is useful to e.g. convert text positions to -pixel positions, in combination with <a class="link" href="GtkLabel.html#gtk-label-get-layout-offsets" title="gtk_label_get_layout_offsets ()"><code class="function">gtk_label_get_layout_offsets()</code></a>. -The returned layout is owned by the <em class="parameter"><code>label</code></em> so need not be -freed by the caller. The <em class="parameter"><code>label</code></em> is free to recreate its layout at -any time, so it should be considered read-only. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"><span class="type">PangoLayout</span></a> for this label. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-line-wrap"></a><h3>gtk_label_get_line_wrap ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_line_wrap (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns whether lines in the label are automatically wrapped. -See <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap" title="gtk_label_set_line_wrap ()"><code class="function">gtk_label_set_line_wrap()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-line-wrap-mode"></a><h3>gtk_label_get_line_wrap_mode ()</h3> -<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="returnvalue">PangoWrapMode</span></a> gtk_label_get_line_wrap_mode (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns line wrap mode used by the label. See <a class="link" href="GtkLabel.html#gtk-label-set-line-wrap-mode" title="gtk_label_set_line_wrap_mode ()"><code class="function">gtk_label_set_line_wrap_mode()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the lines of the label are automatically wrapped.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-mnemonic-widget"></a><h3>gtk_label_get_mnemonic_widget ()</h3> -<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_label_get_mnemonic_widget (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Retrieves the target of the mnemonic (keyboard shortcut) of this -label. See <a class="link" href="GtkLabel.html#gtk-label-set-mnemonic-widget" title="gtk_label_set_mnemonic_widget ()"><code class="function">gtk_label_set_mnemonic_widget()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the target of the label's mnemonic, -or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none has been set and the default algorithm will be used. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span> -</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-selection-bounds"></a><h3>gtk_label_get_selection_bounds ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_selection_bounds (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *start</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *end</code></em>);</pre> -<p> -Gets the selected range of characters in the label, returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> -if there's a selection. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td> -<td>return location for start of selection, as a character offset. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td> -<td>return location for end of selection, as a character offset. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if selection is non-empty</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-use-markup"></a><h3>gtk_label_get_use_markup ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_use_markup (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns whether the label's text is interpreted as marked up with -the <GTKDOCLINK HREF="PangoMarkupFormat">Pango text markup -language</GTKDOCLINK>. See <a class="link" href="GtkLabel.html#gtk-label-set-use-markup" title="gtk_label_set_use_markup ()"><code class="function">gtk_label_set_use_markup()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text will be parsed for markup.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-use-underline"></a><h3>gtk_label_get_use_underline ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_use_underline (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns whether an embedded underline in the label indicates a -mnemonic. See <a class="link" href="GtkLabel.html#gtk-label-set-use-underline" title="gtk_label_set_use_underline ()"><code class="function">gtk_label_set_use_underline()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> whether an embedded underline in the label indicates -the mnemonic accelerator keys.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-single-line-mode"></a><h3>gtk_label_get_single_line_mode ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_single_line_mode (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns whether the label is in single line mode. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the label is in single line mode.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-angle"></a><h3>gtk_label_get_angle ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a> gtk_label_get_angle (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Gets the angle of rotation for the label. See -<a class="link" href="GtkLabel.html#gtk-label-set-angle" title="gtk_label_set_angle ()"><code class="function">gtk_label_set_angle()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the angle of rotation for the label</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-label"></a><h3>gtk_label_set_label ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_label (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre> -<p> -Sets the text of the label. The label is interpreted as -including embedded underlines and/or Pango markup depending -on the values of the <a class="link" href="GtkLabel.html#GtkLabel--use-underline" title='The "use-underline" property'><span class="type">"use-underline"</span></a>" and -<a class="link" href="GtkLabel.html#GtkLabel--use-markup" title='The "use-markup" property'><span class="type">"use-markup"</span></a> properties. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td> -<td>the new text to set for the label</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-use-markup"></a><h3>gtk_label_set_use_markup ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_use_markup (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -Sets whether the text of the label contains markup in <GTKDOCLINK HREF="PangoMarkupFormat">Pango's text markup -language</GTKDOCLINK>. See <a class="link" href="GtkLabel.html#gtk-label-set-markup" title="gtk_label_set_markup ()"><code class="function">gtk_label_set_markup()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label's text should be parsed for markup.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-use-underline"></a><h3>gtk_label_set_use_underline ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_use_underline (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre> -<p> -If true, an underline in the text indicates the next character should be -used for the mnemonic accelerator key. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if underlines in the text indicate mnemonics</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-single-line-mode"></a><h3>gtk_label_set_single_line_mode ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_single_line_mode (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> single_line_mode</code></em>);</pre> -<p> -Sets whether the label is in single line mode. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>single_line_mode</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the label should be in single line mode</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-angle"></a><h3>gtk_label_set_angle ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_angle (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> angle</code></em>);</pre> -<p> -Sets the angle of rotation for the label. An angle of 90 reads from -from bottom to top, an angle of 270, from top to bottom. The angle -setting for the label is ignored if the label is selectable, -wrapped, or ellipsized. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>angle</code></em> :</span></p></td> -<td>the angle that the baseline of the label makes with -the horizontal, in degrees, measured counterclockwise</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-current-uri"></a><h3>gtk_label_get_current_uri ()</h3> -<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_label_get_current_uri (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns the URI for the currently active link in the label. -The active link is the one under the mouse pointer or, in a -selectable label, the link in which the text cursor is currently -positioned. -</p> -<p> -This function is intended for use in a <a class="link" href="GtkLabel.html#GtkLabel-activate-link" title='The "activate-link" signal'><span class="type">"activate-link"</span></a> handler -or for use in a <a class="link" href="GtkWidget.html#GtkWidget-query-tooltip" title='The "query-tooltip" signal'><span class="type">"query-tooltip"</span></a> handler. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td>the currently active URI. The string is owned by GTK+ and must -not be freed or modified.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-set-track-visited-links"></a><h3>gtk_label_set_track_visited_links ()</h3> -<pre class="programlisting"><span class="returnvalue">void</span> gtk_label_set_track_visited_links (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>, - <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_links</code></em>);</pre> -<p> -Sets whether the label should keep track of clicked -links (and use a different color for them). -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>track_links</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to track visited links</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="gtk-label-get-track-visited-links"></a><h3>gtk_label_get_track_visited_links ()</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_label_get_track_visited_links (<em class="parameter"><code><a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label</code></em>);</pre> -<p> -Returns whether the label is currently keeping track -of clicked links. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if clicked links are remembered</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkLabel.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="GtkLabel--angle"></a><h3>The <code class="literal">"angle"</code> property</h3> -<pre class="programlisting"> "angle" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> : Read / Write</pre> -<p> -The angle that the baseline of the label makes with the horizontal, -in degrees, measured counterclockwise. An angle of 90 reads from -from bottom to top, an angle of 270, from top to bottom. Ignored -if the label is selectable, wrapped, or ellipsized. -</p> -<p>Allowed values: [0,360]</p> -<p>Default value: 0</p> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--attributes"></a><h3>The <code class="literal">"attributes"</code> property</h3> -<pre class="programlisting"> "attributes" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Text-Attributes.html#PangoAttrList"><span class="type">PangoAttrList</span></a>* : Read / Write</pre> -<p>A list of style attributes to apply to the text of the label.</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--cursor-position"></a><h3>The <code class="literal">"cursor-position"</code> property</h3> -<pre class="programlisting"> "cursor-position" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read</pre> -<p>The current position of the insertion cursor in chars.</p> -<p>Allowed values: >= 0</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--ellipsize"></a><h3>The <code class="literal">"ellipsize"</code> property</h3> -<pre class="programlisting"> "ellipsize" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoEllipsizeMode"><span class="type">PangoEllipsizeMode</span></a> : Read / Write</pre> -<p> -The preferred place to ellipsize the string, if the label does -not have enough room to display the entire string, specified as a -<span class="type">PangoEllisizeMode</span>. -</p> -<p> -Note that setting this property to a value other than -<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-ELLIPSIZE-NONE:CAPS"><code class="literal">PANGO_ELLIPSIZE_NONE</code></a> has the side-effect that the label requests -only enough space to display the ellipsis "...". In particular, this -means that ellipsizing labels do not work well in notebook tabs, unless -the tab's <span class="type">"tab-expand"</span> property is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Other ways -to set a label's width are <a class="link" href="GtkWidget.html#gtk-widget-set-size-request" title="gtk_widget_set_size_request ()"><code class="function">gtk_widget_set_size_request()</code></a> and -<a class="link" href="GtkLabel.html#gtk-label-set-width-chars" title="gtk_label_set_width_chars ()"><code class="function">gtk_label_set_width_chars()</code></a>. -</p> -<p>Default value: PANGO_ELLIPSIZE_NONE</p> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--justify"></a><h3>The <code class="literal">"justify"</code> property</h3> -<pre class="programlisting"> "justify" <a class="link" href="gtk3-Standard-Enumerations.html#GtkJustification" title="enum GtkJustification"><span class="type">GtkJustification</span></a> : Read / Write</pre> -<p>The alignment of the lines in the text of the label relative to each other. This does NOT affect the alignment of the label within its allocation. See GtkMisc::xalign for that.</p> -<p>Default value: GTK_JUSTIFY_LEFT</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--label"></a><h3>The <code class="literal">"label"</code> property</h3> -<pre class="programlisting"> "label" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write</pre> -<p>The text of the label.</p> -<p>Default value: ""</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--max-width-chars"></a><h3>The <code class="literal">"max-width-chars"</code> property</h3> -<pre class="programlisting"> "max-width-chars" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre> -<p> -The desired maximum width of the label, in characters. If this property -is set to -1, the width will be calculated automatically. -</p> -<p> -See the section on <a class="link" href="GtkLabel.html#label-text-layout" title="Text layout">text layout</a> -for details of how <a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'><span class="type">"width-chars"</span></a> and <a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'><span class="type">"max-width-chars"</span></a> -determine the width of ellipsized and wrapped labels. -</p> -<p>Allowed values: >= G_MAXULONG</p> -<p>Default value: -1</p> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--mnemonic-keyval"></a><h3>The <code class="literal">"mnemonic-keyval"</code> property</h3> -<pre class="programlisting"> "mnemonic-keyval" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> : Read</pre> -<p>The mnemonic accelerator key for this label.</p> -<p>Default value: 16777215</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--mnemonic-widget"></a><h3>The <code class="literal">"mnemonic-widget"</code> property</h3> -<pre class="programlisting"> "mnemonic-widget" <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>* : Read / Write</pre> -<p>The widget to be activated when the label's mnemonic key is pressed.</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--pattern"></a><h3>The <code class="literal">"pattern"</code> property</h3> -<pre class="programlisting"> "pattern" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Write</pre> -<p>A string with _ characters in positions correspond to characters in the text to underline.</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--selectable"></a><h3>The <code class="literal">"selectable"</code> property</h3> -<pre class="programlisting"> "selectable" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>Whether the label text can be selected with the mouse.</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--selection-bound"></a><h3>The <code class="literal">"selection-bound"</code> property</h3> -<pre class="programlisting"> "selection-bound" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read</pre> -<p>The position of the opposite end of the selection from the cursor in chars.</p> -<p>Allowed values: >= 0</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--single-line-mode"></a><h3>The <code class="literal">"single-line-mode"</code> property</h3> -<pre class="programlisting"> "single-line-mode" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Whether the label is in single line mode. In single line mode, -the height of the label does not depend on the actual text, it -is always set to ascent + descent of the font. This can be an -advantage in situations where resizing the label because of text -changes would be distracting, e.g. in a statusbar. -</p> -<p>Default value: FALSE</p> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--track-visited-links"></a><h3>The <code class="literal">"track-visited-links"</code> property</h3> -<pre class="programlisting"> "track-visited-links" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p> -Set this property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to make the label track which links -have been clicked. It will then apply the ::visited-link-color -color, instead of ::link-color. -</p> -<p>Default value: TRUE</p> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--use-markup"></a><h3>The <code class="literal">"use-markup"</code> property</h3> -<pre class="programlisting"> "use-markup" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>The text of the label includes XML markup. See pango_parse_markup().</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--use-underline"></a><h3>The <code class="literal">"use-underline"</code> property</h3> -<pre class="programlisting"> "use-underline" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key.</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--width-chars"></a><h3>The <code class="literal">"width-chars"</code> property</h3> -<pre class="programlisting"> "width-chars" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write</pre> -<p> -The desired width of the label, in characters. If this property is set to --1, the width will be calculated automatically. -</p> -<p> -See the section on <a class="link" href="GtkLabel.html#label-text-layout" title="Text layout">text layout</a> -for details of how <a class="link" href="GtkLabel.html#GtkLabel--width-chars" title='The "width-chars" property'><span class="type">"width-chars"</span></a> and <a class="link" href="GtkLabel.html#GtkLabel--max-width-chars" title='The "max-width-chars" property'><span class="type">"max-width-chars"</span></a> -determine the width of ellipsized and wrapped labels. -</p> -<p>Allowed values: >= G_MAXULONG</p> -<p>Default value: -1</p> -<p class="since">Since 2.6</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--wrap"></a><h3>The <code class="literal">"wrap"</code> property</h3> -<pre class="programlisting"> "wrap" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre> -<p>If set, wrap lines if the text becomes too wide.</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel--wrap-mode"></a><h3>The <code class="literal">"wrap-mode"</code> property</h3> -<pre class="programlisting"> "wrap-mode" <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoWrapMode"><span class="type">PangoWrapMode</span></a> : Read / Write</pre> -<p> -If line wrapping is on (see the <a class="link" href="GtkLabel.html#GtkLabel--wrap" title='The "wrap" property'><span class="type">"wrap"</span></a> property) this controls -how the line wrapping is done. The default is <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-WRAP-WORD:CAPS"><code class="literal">PANGO_WRAP_WORD</code></a>, which -means wrap on word boundaries. -</p> -<p>Default value: PANGO_WRAP_WORD</p> -<p class="since">Since 2.10</p> -</div> -</div> -<div class="refsect1"> -<a name="GtkLabel.signal-details"></a><h2>Signal Details</h2> -<div class="refsect2"> -<a name="GtkLabel-activate-current-link"></a><h3>The <code class="literal">"activate-current-link"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -A <a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user activates a link in the label. -</p> -<p> -Applications may also emit the signal with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> -if they need to control activation of URIs programmatically. -</p> -<p> -The default bindings for this signal are all forms of the Enter key. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>The label on which the signal was emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel-activate-link"></a><h3>The <code class="literal">"activate-link"</code> signal</h3> -<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> user_function (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -The signal which gets emitted to activate a URI. -Applications may connect to it to override the default behaviour, -which is to call <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri" title="gtk_show_uri ()"><code class="function">gtk_show_uri()</code></a>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>The label on which the signal was emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td> -<td>the URI that is activated</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -<tr> -<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the link has been activated</td> -</tr> -</tbody> -</table></div> -<p class="since">Since 2.18</p> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel-copy-clipboard"></a><h3>The <code class="literal">"copy-clipboard"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::copy-clipboard signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted to copy the selection to the clipboard. -</p> -<p> -The default binding for this signal is Ctrl-c. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel-move-cursor"></a><h3>The <code class="literal">"move-cursor"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *entry, - <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> step, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> count, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> extend_selection, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre> -<p> -The ::move-cursor signal is a -<a class="link" href="gtk3-Bindings.html#keybinding-signals">keybinding signal</a> -which gets emitted when the user initiates a cursor movement. -If the cursor is not visible in <em class="parameter"><code>entry</code></em>, this signal causes -the viewport to be moved instead. -</p> -<p> -Applications should not connect to it, but may emit it with -<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-emit-by-name"><code class="function">g_signal_emit_by_name()</code></a> if they need to control the cursor -programmatically. -</p> -<p> -The default bindings for this signal come in two variants, -the variant with the Shift modifier extends the selection, -the variant without the Shift modifer does not. -There are too many key combinations to list them all here. -</p> -<div class="itemizedlist"><ul class="itemizedlist" type="disc"> -<li class="listitem">Arrow keys move by individual characters/lines</li> -<li class="listitem">Ctrl-arrow key combinations move by words/paragraphs</li> -<li class="listitem">Home/End keys move to the ends of the buffer</li> -</ul></div> -<p> -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td> -<td>the object which received the signal</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>step</code></em> :</span></p></td> -<td>the granularity of the move, as a <a class="link" href="gtk3-Standard-Enumerations.html#GtkMovementStep" title="enum GtkMovementStep"><span class="type">GtkMovementStep</span></a> -</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td> -<td>the number of <em class="parameter"><code>step</code></em> units to move</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>extend_selection</code></em> :</span></p></td> -<td> -<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the move should extend the selection</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -<hr> -<div class="refsect2"> -<a name="GtkLabel-populate-popup"></a><h3>The <code class="literal">"populate-popup"</code> signal</h3> -<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> *label, - <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu, - <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre> -<p> -The ::populate-popup signal gets emitted before showing the -context menu of the label. Note that only selectable labels -have context menus. -</p> -<p> -If you need to add items to the context menu, connect -to this signal and append your menuitems to the <em class="parameter"><code>menu</code></em>. -</p> -<div class="variablelist"><table border="0"> -<col align="left" valign="top"> -<tbody> -<tr> -<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td> -<td>The label on which the signal is emitted</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td> -<td>the menu that is being populated</td> -</tr> -<tr> -<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td> -<td>user data set when the signal handler was connected.</td> -</tr> -</tbody> -</table></div> -</div> -</div> -</div> -<div class="footer"> -<hr> - Generated by GTK-Doc V1.18.1</div> -</body> -</html>
\ No newline at end of file |