AdwWindowTitle

AdwWindowTitle — A helper widget for setting a window's title and subtitle

Functions

GtkWidget * adw_window_title_new ()
void adw_window_title_set_title ()
const char * adw_window_title_get_title ()
void adw_window_title_set_subtitle ()
const char * adw_window_title_get_subtitle ()

Properties

char * subtitle Read / Write
char * title Read / Write

Types and Values

#define ADW_TYPE_WINDOW_TITLE
  AdwWindowTitle

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── AdwWindowTitle

Implemented Interfaces

AdwWindowTitle implements GtkAccessible, GtkBuildable and GtkConstraintTarget.

Description

A helper widget for setting a window's title and subtitle. Made to simplify having a different title from the window in the headerbar.

CSS nodes

AdwWindowTitle has a single CSS node with name windowtitle.

Functions

adw_window_title_new ()

GtkWidget *
adw_window_title_new (const char *title,
                      const char *subtitle);

Creates a new AdwWindowTitle widget.

Parameters

title

a title, or NULL.

[nullable]

subtitle

a subtitle, or NULL.

[nullable]

Returns

a new AdwWindowTitle

Since: 1.0

adw_window_title_set_title ()

void
adw_window_title_set_title (AdwWindowTitle *self,
                            const char *title);

Sets the title of self .

The title typically identifies the current view or content item, and generally does not use the application name.

Parameters

self

a AdwWindowTitle

  

title

a title, or NULL.

[nullable]

Since: 1.0

adw_window_title_get_title ()

const char *
adw_window_title_get_title (AdwWindowTitle *self);

Gets the title of self . See adw_window_title_set_title().

Parameters

self

a AdwWindowTitle

  

Returns

the title of self , or NULL.

[transfer none][nullable]

Since: 1.0

adw_window_title_set_subtitle ()

void
adw_window_title_set_subtitle (AdwWindowTitle *self,
                               const char *subtitle);

Sets the subtitle of self .

The subtitle should give a user additional details.

Parameters

self

a AdwWindowTitle

  

subtitle

a subtitle, or NULL.

[nullable]

Since: 1.0

adw_window_title_get_subtitle ()

const char *
adw_window_title_get_subtitle (AdwWindowTitle *self);

Gets the subtitle of self . See adw_window_title_set_subtitle().

Parameters

self

a AdwWindowTitle

  

Returns

the subtitle of self , or NULL.

[transfer none][nullable]

Since: 1.0

Types and Values

ADW_TYPE_WINDOW_TITLE

#define ADW_TYPE_WINDOW_TITLE (adw_window_title_get_type())

AdwWindowTitle

typedef struct _AdwWindowTitle AdwWindowTitle;

Property Details

The “subtitle” property

  “subtitle”                 char *

The subtitle to display.

The subtitle should give a user additional details.

Owner: AdwWindowTitle

Flags: Read / Write

Default value: NULL

Since: 1.0

The “title” property

  “title”                    char *

The title to display.

The title typically identifies the current view or content item, and generally does not use the application name.

Owner: AdwWindowTitle

Flags: Read / Write

Default value: NULL

Since: 1.0

See Also

AdwHeaderBar

Generated by GTK-Doc V1.33.1