### Constructor

# Gtk Label new_with_mnemonic

#### Declaration [src]

    GtkWidget*
    gtk_label_new_with_mnemonic (
      const char* str
    )

#### Description [src]

Creates a new `GtkLabel`, containing the text in `str`.

If characters in `str` 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 `gtk_label_set_mnemonic_widget()`.

If `gtk_label_set_mnemonic_widget()` is not called, then the first activatable ancestor of the `GtkLabel` 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.

#### Parameters

`str`

  Type: `const char*`

  The text of the label, with an underscore in front of the mnemonic character.

  The argument can be `NULL`.
  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

#### Return value

Type: `GtkWidget`

The new `GtkLabel`

The data is owned by the called function.