Panel Plugin Register Macros (4.6 Style): Libxfce4panel Reference Manual

Panel Plugin Register Macros (4.6 Style)

Panel Plugin Register Macros (4.6 Style) — The 4.6 way of registering plugins that compiled as executables

Functions

#define	XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL()
#define	XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_FULL()
#define	XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK()
#define	XFCE_PANEL_PLUGIN_REGISTER_INTERNAL()
#define	XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK()

Includes

#include <libxfce4panel/libxfce4panel.h>

Description

Macros to register old external panel plugins that are compiled as executables.

Functions

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL()

#define             XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL(construct_func)

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL has been deprecated since version 4.8 and should not be used in newly-written code.

Deprecation is not entirely true, but it should be made clear that it is recommended to use XFCE_PANEL_PLUGIN_REGISTER(). See the Registering Plugins for more information.

Registers and initializes the plugin. This is the only thing that is required to create a panel plugin.

Parameters

construct_func

name of a function that can be cast to an XfcePanelPluginFunc

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_FULL()

#define             XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_FULL(construct_func, preinit_func, check_func)

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_FULL has been deprecated since version 4.8 and should not be used in newly-written code.

Deprecation is not entirely true, but it should be made clear that it is recommended to use XFCE_PANEL_PLUGIN_REGISTER_FULL(). See the Registering Plugins for more information.

Same as XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK(), but with a preinit function that is called before gtk_init(). This allows plugins to initialize libraries or threads.

Parameters

construct_func	name of a function that can be cast to an XfcePanelPluginFunc
preinit_func	name of a function that can be case to XfcePanelPluginPreInit or `NULL`
check_func	name of a function that can be cast to an XfcePanelPluginCheck or `NULL`

Since: 4.6

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK()

#define             XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK(construct_func ,check_func)

XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL_WITH_CHECK has been deprecated since version 4.8 and should not be used in newly-written code.

Deprecation is not entirely true, but it should be made clear that it is recommended to use XFCE_PANEL_PLUGIN_REGISTER_WITH_CHECK(). See the Registering Plugins for more information.

Registers and initializes the plugin. This is the only thing that is required to create a panel plugin. The check functions is run before creating the plugin, and should return FALSE if plugin creation is not possible.

Parameters

construct_func	name of a function that can be cast to an XfcePanelPluginFunc
check_func	name of a function that can be cast to an XfcePanelPluginCheck or `NULL`

XFCE_PANEL_PLUGIN_REGISTER_INTERNAL()

#define             XFCE_PANEL_PLUGIN_REGISTER_INTERNAL(construct_func)

XFCE_PANEL_PLUGIN_REGISTER_INTERNAL has been deprecated since version 4.8 and should not be used in newly-written code.

Use XFCE_PANEL_PLUGIN_REGISTER() instead.

See XFCE_PANEL_PLUGIN_REGISTER() for more information.

Parameters

construct_func

name of a function that can be cast to an XfcePanelPluginFunc

XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK()

#define             XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK(construct_func ,check_func)

XFCE_PANEL_PLUGIN_REGISTER_INTERNAL_WITH_CHECK has been deprecated since version 4.8 and should not be used in newly-written code.

use XFCE_PANEL_PLUGIN_REGISTER_WITH_CHECK() instead.

See XFCE_PANEL_PLUGIN_REGISTER() for more information.

Parameters

construct_func	name of a function that can be cast to an XfcePanelPluginFunc
check_func	name of a function that can be cast to an XfcePanelPluginCheck or `NULL`