Constructor
GtkLabelnew_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 |
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
Returns: | GtkWidget |
The new |
|
The data is owned by the called function. |