gtklabel.html

最新gtk中文资料集

</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3456178"></a><h3>
<a name="gtk-label-set"></a>gtk_label_set</h3>
<a class="indexterm" name="id3456193"></a><pre class="programlisting">#define  gtk_label_set           gtk_label_set_text
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_label_set</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Aliases <a class="link" href="GtkLabel.html#gtk-label-set-text"><code class="function">gtk_label_set_text()</code></a>.  Probably used for backward compatibility with
GTK+ 1.0.x.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3456233"></a><h3>
<a name="gtk-label-get-layout-offsets"></a>gtk_label_get_layout_offsets ()</h3>
<a class="indexterm" name="id3456246"></a><pre class="programlisting">void                gtk_label_get_layout_offsets        (<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a> *label,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *y);</pre>
<p>
Obtains the coordinates where the label will draw the <a
href="/usr/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="/usr/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 class="link" href="GtkWidget.html#GTK-NO-WINDOW:CAPS"><span class="type">GTK_NO_WINDOW</span></a> widget. Remember
when using the <a
href="/usr/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="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"
><code class="function">PANGO_PIXELS()</code></a> or <a
href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"
><span class="type">PANGO_SCALE</span></a>.</p>
<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>&#160;:</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>&#160;:</span></p></td>
<td> location to store X offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td>
<td> location to store Y offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3456437"></a><h3>
<a name="gtk-label-get-mnemonic-keyval"></a>gtk_label_get_mnemonic_keyval ()</h3>
<a class="indexterm" name="id3456451"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>               gtk_label_get_mnemonic_keyval       (<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a> *label);</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>
<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>&#160;:</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>&#160;:</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" lang="en">
<a name="id3456539"></a><h3>
<a name="gtk-label-get-selectable"></a>gtk_label_get_selectable ()</h3>
<a class="indexterm" name="id3456552"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_label_get_selectable            (<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a> *label);</pre>
<p>
Gets the value set by <a class="link" href="GtkLabel.html#gtk-label-set-selectable"><code class="function">gtk_label_set_selectable()</code></a>.</p>
<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>&#160;:</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>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/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" lang="en">
<a name="id3456641"></a><h3>
<a name="gtk-label-get-text"></a>gtk_label_get_text ()</h3>
<a class="indexterm" name="id3456654"></a><pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_label_get_text                  (<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a> *label);</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"><code class="function">gtk_label_get_label()</code></a>)</p>
<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>&#160;:</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>&#160;:</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" lang="en">
<a name="id3456738"></a><h3>
<a name="gtk-label-new-with-mnemonic"></a>gtk_label_new_with_mnemonic ()</h3>
<a class="indexterm" name="id3456752"></a><pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_label_new_with_mnemonic         (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *str);</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"><code class="function">gtk_label_set_mnemonic_widget()</code></a>.
</p>
<p>
If <a class="link" href="GtkLabel.html#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>
<p>

</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>&#160;:</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>&#160;:</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" lang="en">
<a name="id3456887"></a><h3>
<a name="gtk-label-select-region"></a>gtk_label_select_region ()</h3>
<a class="indexterm" name="id3456900"></a><pre class="programlisting">void                gtk_label_select_region             (<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a> *label,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> start_offset,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> end_offset);</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"><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>
<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>&#160;:</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>&#160;:</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>&