GtefApplicationWindow: Gtef 2 Reference Manual

## GtefApplicationWindow GtefApplicationWindow — An extension of GtkApplicationWindow |

## Functions

GtefApplicationWindow * | gtef_application_window_get_from_gtk_application_window ()
GtkApplicationWindow * | gtef_application_window_get_application_window ()
GtkStatusbar * | gtef_application_window_get_statusbar ()
void | gtef_application_window_set_statusbar ()
void | gtef_application_window_connect_menu_to_statusbar ()
void | gtef_application_window_connect_recent_chooser_menu_to_statusbar ()
GtkWidget * | gtef_application_window_create_open_recent_menu_item ()

## Properties

GtkApplicationWindow * | application-window | Read / Write / Construct Only
GtkStatusbar * | statusbar | Read / Write

## Types and Values

| GtefApplicationWindow

## Object Hierarchy

        GObject
        ╰── GtefApplicationWindow

## Includes

    #include <gtef/gtef.h>

## Description

GtefApplicationWindow extends the GtkApplicationWindow class.

Note that GtefApplicationWindow extends the GtkApplicationWindow class but without subclassing it, because several libraries might want to extend GtkApplicationWindow and an application needs to be able to use all those extensions at the same time.

## Functions

### gtef_application_window_get_from_gtk_application_window ()

    GtefApplicationWindow *
    gtef_application_window_get_from_gtk_application_window
                                   (GtkApplicationWindow *gtk_window);

Returns the GtefApplicationWindow of `gtk_window` . The returned object is guaranteed to be the same for the lifetime of `gtk_window` .

#### Parameters

gtk_window | a GtkApplicationWindow. |

#### Returns

the GtefApplicationWindow of `gtk_window` .

[transfer none]

Since: 2.0

### gtef_application_window_get_application_window ()

    GtkApplicationWindow *
    gtef_application_window_get_application_window
                                   (GtefApplicationWindow *gtef_window);

#### Parameters

gtef_window | a GtefApplicationWindow. |

#### Returns

the GtkApplicationWindow of `gtef_window` .

[transfer none]

Since: 2.0

### gtef_application_window_get_statusbar ()

    GtkStatusbar *
    gtef_application_window_get_statusbar (GtefApplicationWindow *gtef_window);

#### Parameters

gtef_window | a GtefApplicationWindow. |

#### Returns

the “statusbar”.

[transfer none][nullable]

Since: 2.0

### gtef_application_window_set_statusbar ()

    void
    gtef_application_window_set_statusbar (GtefApplicationWindow *gtef_window,
                                           GtkStatusbar *statusbar);

Sets the “statusbar” property.

#### Parameters

gtef_window | a GtefApplicationWindow. |
statusbar | a GtkStatusbar, or `NULL`. | [nullable]

Since: 2.0

### gtef_application_window_connect_menu_to_statusbar ()

    void
    gtef_application_window_connect_menu_to_statusbar
                                   (GtefApplicationWindow *gtef_window,
                                    GtefMenuShell *gtef_menu_shell);

Connect to the “menu-item-selected” and “menu-item-deselected” signals of `gtef_menu_shell` to push/pop the long description of GtkMenuItem's to the “statusbar”.

The long description is retrieved with `gtef_menu_item_get_long_description()`. So `gtef_menu_item_set_long_description()` must have been called, which is the case if the GtkMenuItem has been created with the functions available in GtefActionInfoStore.

#### Parameters

gtef_window | a GtefApplicationWindow. |
gtef_menu_shell | a GtefMenuShell. |

Since: 2.0

### gtef_application_window_connect_recent_chooser_menu_to_statusbar ()

    void
    gtef_application_window_connect_recent_chooser_menu_to_statusbar
                                   (GtefApplicationWindow *gtef_window,
                                    GtkRecentChooserMenu *menu);

An alternative to `gtk_recent_chooser_set_show_tips()`. Shows the full path in the “statusbar” when a GtkMenuItem of `menu` is selected.

The full path is retrieved with `gtef_utils_recent_chooser_menu_get_item_uri()`.

#### Parameters

gtef_window | a GtefApplicationWindow. |
menu | a GtkRecentChooserMenu. |

Since: 2.0

### gtef_application_window_create_open_recent_menu_item ()

    GtkWidget *
    gtef_application_window_create_open_recent_menu_item
                                   (GtefApplicationWindow *gtef_window);

Creates a GtkMenuItem with a simple and generic GtkRecentChooserMenu as submenu.

The GtkRecentChooser is configured to show files only recently used with the current application, as returned by `g_get_application_name()`. If recent files are added to the default GtkRecentManager with `gtk_recent_manager_add_item()`, the files will normally show up in the GtkRecentChooserMenu.

The GtkRecentChooserMenu is connected to the statusbar with `gtef_application_window_connect_recent_chooser_menu_to_statusbar()`.

When the “item-activated” signal is emitted, `gtef_application_open_simple()` is called, so the GApplication must have the `G_APPLICATION_HANDLES_OPEN` flag set.

#### Parameters

gtef_window | a GtefApplicationWindow. |

#### Returns

a new GtkMenuItem.

[transfer floating]

Since: 2.0

## Types and Values

### GtefApplicationWindow

    typedef struct _GtefApplicationWindow GtefApplicationWindow;

## Property Details

### The `“application-window”` property

      “application-window”       GtkApplicationWindow *

The GtkApplicationWindow.

Flags: Read / Write / Construct Only

Since: 2.0

### The `“statusbar”` property

      “statusbar”                GtkStatusbar *

The GtkStatusbar. `NULL` by default.

Flags: Read / Write

Since: 2.0