Virtual Method

GtkUIManagerget_widget

deprecated: 3.10 since: 2.4

Declaration [src]

GtkWidget*
get_widget (
  GtkUIManager* manager,
  const gchar* path
)

Description [src]

Looks up a widget by following a path. The path consists of the names specified in the XML description of the UI. separated by “/”. Elements which don’t have a name or action attribute in the XML (e.g. <popup>) can be addressed by their XML element name (e.g. “popup”). The root element (“/ui”) can be omitted in the path.

Note that the widget found by following a path that ends in a <menu>; element is the menuitem to which the menu is attached, not the menu it manages.

Also note that the widgets constructed by a ui manager are not tied to the lifecycle of the ui manager. If you add the widgets returned by this function to some container or explicitly ref them, they will survive the destruction of the ui manager.

Available since: 2.4

Deprecated since: 3.10

Please do not use it in newly written code.

Parameters

path

Type: const gchar*

A path.

The data is owned by the caller of the method.

The value is a NUL terminated UTF-8 string.

Return value

Type: GtkWidget

The widget found by following the path, or NULL if no widget was found.

The returned data is owned by the instance.