Method

GtkWidgetcreate_pango_layout

Declaration [src]

PangoLayout*
gtk_widget_create_pango_layout (
  GtkWidget* widget,
  const gchar* text
)

Description [src]

Creates a new PangoLayout with the appropriate font map, font description, and base direction for drawing text for this widget.

If you keep a PangoLayout created in this way around, you need to re-create it when the widget PangoContext is replaced. This can be tracked by using the GtkWidget::screen-changed signal on the widget.

Parameters

text

Type: const gchar*

Text to set on the layout (can be NULL).

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.

Return value

Type: PangoLayout

The new PangoLayout.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.