GtkSource.PrintCompositor.set_header_format

### Method

# GtkSource PrintCompositorset_header_format

#### Declaration [src]

    void
    gtk_source_print_compositor_set_header_format (
      GtkSourcePrintCompositor* compositor,
      gboolean separator,
      const gchar* left,
      const gchar* center,
      const gchar* right
    )

#### Description [src]

Sets strftime like header format strings, to be printed on the left, center and right of the top of each page.

The strings may include strftime(3) codes which will be expanded at print time. A subset of `strftime()` codes are accepted, see `g_date_time_format()` for more details on the accepted format specifiers. Additionally the following format specifiers are accepted:

- # N: the page number

- # Q: the page count.

`separator` specifies if a solid line should be drawn to separate the header from the document text.

If `NULL` is given for any of the three arguments, that particular string will not be printed.

For the header to be printed, in addition to specifying format strings, you need to enable header printing with `gtk_source_print_compositor_set_print_header()`.

This function cannot be called anymore after the first call to the `gtk_source_print_compositor_paginate()` function.

#### Parameters

`separator`

  Type: `gboolean`

  `TRUE` if you want a separator line to be printed.

`left`

  Type: `const gchar*`

  A format string to print on the left of the header.

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

`center`

  Type: `const gchar*`

  A format string to print on the center of the header.

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

`right`

  Type: `const gchar*`

  A format string to print on the right of the header.

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