Constructor

GtkShortcutTriggerparse_string

Declaration [src]

GtkShortcutTrigger*
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 >.

Parameters

string const char*
 

The string to parse.

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

Return value

Returns: 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.