## Convenience Functions

Convenience Functions — Special purpose widgets and utilities.

## Synopsis

    #include <libxfce4panel/libxfce4panel.h>

    GtkWidget*          xfce_create_panel_button            (void);
    GtkWidget*          xfce_create_panel_toggle_button     (void);
    gboolean            xfce_allow_panel_customization      (void);

## Description

This section describes a number of functions that were created to help developers of Xfce Panel plugins.

## Details

### xfce_create_panel_button ()

    GtkWidget*          xfce_create_panel_button            (void);

Create regular GtkButton with a few properties set to be useful in the Xfce panel: Flat (`GTK_RELIEF_NONE`), no focus on click and minimal padding.

Returns : | newly created GtkButton.

### xfce_create_panel_toggle_button ()

    GtkWidget*          xfce_create_panel_toggle_button     (void);

Create regular GtkToggleButton with a few properties set to be useful in Xfce panel: Flat (`GTK_RELIEF_NONE`), no focus on click and minimal padding.

Returns : | newly created GtkToggleButton.

### xfce_allow_panel_customization ()

    gboolean            xfce_allow_panel_customization      (void);

Check if the user is allowed to customize the panel. Uses the kiosk mode implementation from libxfce4util.

Returns : | `TRUE` if the user is allowed to customize the panel, `FALSE` otherwise.