Declaration [src]

gtk_shortcut_trigger_parse_string (
  const char* string

Description [src]

Tries to parse the given string into a trigger.

On success, the parsed trigger is returned. When parsing failed, NULL is returned.

The accepted strings are:

  • never, for GtkNeverTrigger
  • a string parsed by gtk_accelerator_parse(), for a GtkKeyvalTrigger, e.g. <Control>C
  • underscore, followed by a single character, for GtkMnemonicTrigger, e.g. _l
  • two valid trigger strings, separated by a | character, for a GtkAlternativeTrigger: <Control>q|<Control>w

Note that you will have to escape the < and > characters when specifying triggers in XML files, such as GtkBuilder ui files. Use &lt; instead of < and &gt; instead of >.



Type: const char*

The string to parse.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: GtkShortcutTrigger

A new GtkShortcutTrigger

The caller of the function takes ownership of the data, and is responsible for freeing it.
The return value can be NULL.