GtkLabel

显示少量文本。

大多数标签用于标记另一个小部件（例如 GtkEntry）。

快捷键和手势

GtkLabel 当光标可见时支持以下键盘快捷键：

• Shift+F10 或 Menu 打开上下文菜单。
• Ctrl+A 或 Ctrl+/ 选择全部。
• Ctrl+Shift+A 或 Ctrl+\ 取消选择全部。

此外，以下信号具有默认的键绑定：

• GtkLabel::activate-current-link
• GtkLabel::copy-clipboard
• GtkLabel::move-cursor

行为

GtkLabel 定义了一系列内置行为

• clipboard.copy 将文本复制到剪贴板。
• clipboard.cut 不做任何事情，因为标签中的文本无法删除。
• clipboard.paste 不做任何事情，因为标签中的文本无法编辑。
• link.open 当在标签内的链接上激活时，打开链接。
• link.copy 当在标签内的链接上激活时，将链接复制到剪贴板。
• menu.popup 打开上下文菜单。
• selection.delete 不做任何事情，因为标签中的文本无法删除。
• selection.select-all 选择全部文本，如果标签允许选择。

CSS 节点

label
├── [selection]
├── [link]
┊
╰── [link]

GtkLabel 有一个名为 label 的单一 CSS 节点。可以为标签应用各种样式类，如 .title、.subtitle、.dim-label 等。在 GtkShortcutsWindow 中，标签使用 .keycap 样式类。

如果标签有选择，它会获得一个名为 selection 的子节点。

如果标签有链接，则每个链接有一个子节点。这些子节点根据它们是否被访问携带链接或访问状态。在这种情况下，标签节点也获得一个 .link 样式类。

作为可构建的 GtkLabel

GtkBuildable 接口的 GtkLabel 实现支持一个自定义的 <attributes> 元素，该元素支持任意数量的 <attribute> 元素。此 <attribute> 元素具有名为“name”、“value”、“start”和“end”的属性，您可以使用此 PangoAttribute 值指定此标签。

UI 定义片段示例，指定 Pango 属性

<object class="GtkLabel">
  <attributes>
    <attribute name="weight" value="PANGO_WEIGHT_BOLD"/>
    <attribute name="background" value="red" start="5" end="10"/>
  </attributes>
</object>

起始和结束属性指定 Pango 属性应用的字符范围。如果未指定起始和结束，则属性应用于全部文本。注意，指定范围与可翻译属性不甚合理。相反，请使用嵌入在可翻译内容中的标记。

无障碍性

GtkLabel 使用 GTK_ACCESSIBLE_ROLE_LABEL 角色。

快捷键

标签可能包含“助记符”。助记符是标签下划线的字符，用于键盘导航。助记符是在保留字符之前提供带有下划线的字符串，例如"_File"，传递到函数gtk_label_new_with_mnemonic()或gtk_label_set_text_with_mnemonic()。

助记符会自动激活标签内部的任何可激活小部件，例如一个GtkButton；如果标签不在助记符的目标小部件内，您必须使用gtk_label_set_mnemonic_widget()告诉标签关于目标的信息。

这里有一个简单的例子，其中标签在一个按钮内

// Pressing Alt+H will activate this button
GtkWidget *button = gtk_button_new ();
GtkWidget *label = gtk_label_new_with_mnemonic ("_Hello");
gtk_button_set_child (GTK_BUTTON (button), label);

有一个方便的函数可以创建已经包含助记符标签的按钮

// Pressing Alt+H will activate this button
GtkWidget *button = gtk_button_new_with_mnemonic ("_Hello");

要为标签旁边的底层小部件创建助记符，例如一个GtkEntry，您必须使用gtk_label_set_mnemonic_widget()将标签指向该表单

// Pressing Alt+H will focus the entry
GtkWidget *entry = gtk_entry_new ();
GtkWidget *label = gtk_label_new_with_mnemonic ("_Hello");
gtk_label_set_mnemonic_widget (GTK_LABEL (label), entry);

标记语言（样式化文本）

为了轻松在标签中格式化文本（更改颜色、字体等），标签文本可以用简单的标记语言提供

这就是创建小字的标签的方法

GtkWidget *label = gtk_label_new (NULL);
gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>");

（有关可用标记和完整文档，请参阅Pango手册][pango_parse_markup()）

gtk_label_set_markup()传递的标记必须是有效的XML；例如，均为字面字符<、>和&必须转义为<、>和&。如果您将用户、文件或网络获得的文本传递到gtk_label_set_markup()，您希望使用g_markup_escape_text()或g_markup_printf_escaped()进行转义。

标记字符串只是设置标签的便利方式PangoAttrList；在某些情况下，可能使用gtk_label_set_attributes()更简单。但是要小心；PangoAttrList往往会引起国际化问题，除非您将属性应用于整个字符串（即，除非您将每个属性的range设置为[0, G_MAXINT])。原因是指定PangoAttribute的start_index和end_index需要了解确切显示的字符串，因此翻译会导致问题。

可选择的标签

可以使用gtk_label_set_selectable()使标签可选择。可选择标签允许用户将标签内容复制到剪贴板。只有包含可复制信息（例如错误消息）的标签才应该设置为可选择。

文本布局

标签可以包含任意数量的段落，但如果包含的段落数过多，将会有性能问题。段落由新行或其他Pango理解的段落分隔符分隔。

如果调用gtk_label_set_wrap()，标签可以自动换行。

gtk_label_set_justify() 设置标签中行之间的对齐方式。如果您想要设置标签在整个可用空间中的对齐方式，请查看 GtkWidget:halign 和 GtkWidget:valign 属性。

GtkLabel:width-chars 和 GtkLabel:max-width-chars 属性可用于控制省略或换行标签的大小分配。对于省略标签，如果指定了任一属性（且小于实际文本大小），则用作最小宽度，实际文本大小用作标签的自然宽度。对于换行标签，如果指定了 width-chars，则用作最小宽度，max-width-chars 用作自然宽度。即使指定了 max-width-chars，换行标签也将重新换行以使用所有的可用宽 度。

链接

GTK 除了常规的 Pango 标记外，还支持可点击的超链接的标记。链接的标记借用了 HTML，使用具有“href”“title”和“class”属性的 <a> 标签。 GTK 以类似于在网页浏览器中显示的方式渲染链接，带有带颜色的下划线文本。“title”属性作为链接的提示显示。 “class”属性用作链接的 CSS 节点的样式类。

内联链接的示例看起来像这样

const char *text =
"Go to the "
"<a href=\"https://gtk.org.cn\" title=\"&lt;i&gt;Our&lt;/i&gt; website\">"
"GTK website</a> for more...";
GtkWidget *label = gtk_label_new (NULL);
gtk_label_set_markup (GTK_LABEL (label), text);

通过使用 GtkLabel::activate-link 信号和 gtk_label_get_current_uri() 函数，可以实现针对链接和其工具提示的自定义处理。