gtk:label-mnemonic-widget (object)

object -- a gtk:label widget
widget -- a gtk:widget target

Accessor of the mnemonic-widget slot of the gtk:label class. The gtk:label-mnemonic-widget function returns the target of the mnemonic of the label, or nil if none has been set and the default algorithm will be used.

If the label has been set so that it has an mnemonic key, using the gtk:label-set-markup-with-mnemonic, gtk:label-set-text-with-mnemonic, gtk:label-new-with-mnemonic functions 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 gtk:button widget or a gtk:notebook tab, it is automatically associated with the correct widget, but sometimes, for example, when the target is a gtk:entry widget next to the label, you need to set it explicitly using this function.

The target widget will be accelerated by emitting the "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.