Libxfce4panel Reference Manual: Commonly used plugin macros

## Commonly used plugin macros Commonly used plugin macros — Various macros to make life easier for plugin developers. |

## Functions

#define | XFCE_PANEL_CHANNEL_NAME
#define | panel_slice_alloc()
#define | panel_slice_alloc0()
#define | panel_slice_free()
#define | panel_slice_free1()
#define | panel_slice_new()
#define | panel_slice_new0()
#define | PANEL_PARAM_READABLE
#define | PANEL_PARAM_READWRITE
#define | PANEL_PARAM_WRITABLE

## Includes

    #include <libxfce4panel/libxfce4panel.h>

## Description

Some commonly used macros in panel plugins.

## Functions

### XFCE_PANEL_CHANNEL_NAME

    #define XFCE_PANEL_CHANNEL_NAME (xfce_panel_get_channel_name ())

Macro to return the value of `xfce_panel_get_channel_name()`.

See also: xfce_panel_plugin_xfconf_channel_new, xfce_panel_plugin_get_property_base

Since 4.8

### panel_slice_alloc()

    #define panel_slice_alloc(block_size) (g_slice_alloc ((block_size)))

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_alloc()` instead.

See `g_slice_alloc()` for more information.

#### Parameters

block_size | the number of bytes to allocate |

#### Returns

a pointer to the allocated memory block

### panel_slice_alloc0()

    #define panel_slice_alloc0(block_size) (g_slice_alloc0 ((block_size)))

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_alloc0()` instead.

See `g_slice_alloc0()` for more information.

#### Parameters

block_size | the number of bytes to allocate |

#### Returns

a pointer to the allocated memory block

### panel_slice_free()

    #define panel_slice_free(type, ptr) G_STMT_START{ g_slice_free (type, (ptr)); }G_STMT_END

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_free()` instead.

See `g_slice_free()` for more information.

#### Parameters

type | the type to allocate, typically a structure name |
ptr | a pointer to the block to free |

### panel_slice_free1()

    #define panel_slice_free1(block_size, mem_block) G_STMT_START{ g_slice_free1 ((block_size), (mem_block)); }G_STMT_END

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_free1()` instead.

See `g_slice_free1()` for more information.

#### Parameters

block_size | the size of the block |
mem_block | a pointer to the block to free |

### panel_slice_new()

    #define panel_slice_new(type) (g_slice_new (type))

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_new()` instead.

See `g_slice_new()` for more information.

#### Parameters

type | the type to allocate, typically a structure name |

#### Returns

a pointer to the allocated memory block

### panel_slice_new0()

    #define panel_slice_new0(type) (g_slice_new0 (type))

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

Deprecated because panel depends on recent enough version of glib. Use `g_slice_new0()` instead.

See `g_slice_new0()` for more information.

#### Parameters

type | the type to allocate, typically a structure name |

#### Returns

a pointer to the allocated memory block

### PANEL_PARAM_READABLE

    #define PANEL_PARAM_READABLE (G_PARAM_READABLE | G_PARAM_STATIC_STRINGS)

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

Deprecated because panel depends on recent enough version of glib. Use G_PARAM_READABLE | G_PARAM_STATIC_STRINGS instead.

Macro for G_PARAM_READABLE with static strings.

### PANEL_PARAM_READWRITE

    #define PANEL_PARAM_READWRITE (G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)

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

Deprecated because panel depends on recent enough version of glib. Use G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS instead.

Macro for G_PARAM_READWRITE with static strings.

### PANEL_PARAM_WRITABLE

    #define PANEL_PARAM_WRITABLE (G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS)

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

Deprecated because panel depends on recent enough version of glib. Use G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS instead.

Macro for PANEL_PARAM_WRITABLE with static strings.

## Types and Values