XfcePanelWindow

XfcePanelWindow —

A toplevel borderless window with optional move handles.

Synopsis




                    XfcePanelWindow;
void                (*XfcePanelWindowMoveFunc)          (GtkWidget *widget,
                                                         gpointer data,
                                                         int *x,
                                                         int *y);
void                (*XfcePanelWindowResizeFunc)        (GtkWidget *widget,
                                                         gpointer data,
                                                         GtkAllocation *previous,
                                                         GtkAllocation *allocation,
                                                         int *x,
                                                         int *y);
GtkWidget*          xfce_panel_window_new               (void);
void                xfce_panel_window_set_orientation   (XfcePanelWindow *window,
                                                         GtkOrientation orientation);
GtkOrientation      xfce_panel_window_get_orientation   (XfcePanelWindow *window);
void                xfce_panel_window_set_handle_style  (XfcePanelWindow *window,
                                                         XfceHandleStyle handle_style);
XfceHandleStyle     xfce_panel_window_get_handle_style  (XfcePanelWindow *window);
void                xfce_panel_window_set_show_border   (XfcePanelWindow *window,
                                                         gboolean top_border,
                                                         gboolean bottom_border,
                                                         gboolean left_border,
                                                         gboolean right_border);
void                xfce_panel_window_get_show_border   (XfcePanelWindow *window,
                                                         gboolean *top_border,
                                                         gboolean *bottom_border,
                                                         gboolean *left_border,
                                                         gboolean *right_border);
void                xfce_panel_window_set_resize_function
                                                        (XfcePanelWindow *window,
                                                         XfcePanelWindowResizeFunc function,
                                                         gpointer data);
void                xfce_panel_window_set_move_function (XfcePanelWindow *window,
                                                         XfcePanelWindowMoveFunc function,
                                                         gpointer data);
void                xfce_panel_window_set_movable       (XfcePanelWindow *window,
                                                         gboolean movable);
gboolean            xfce_panel_window_get_movable       (XfcePanelWindow *window);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----XfcePanelWindow

Implemented Interfaces

XfcePanelWindow implements AtkImplementorIface.

Properties


  "handle-style"             XfceHandleStyle       : Read / Write
  "orientation"              GtkOrientation        : Read / Write

Signals


  "move"                                           : Run Last
  "move-end"                                       : Run Last
  "move-start"                                     : Run Last
  "orientation-changed"                            : Run First

Description

A widget derived from GtkWindow that implements a toplevel window for panels. It optionally can have one or two move handles.

Details

XfcePanelWindow

typedef struct _XfcePanelWindow XfcePanelWindow;

The XfcePanelWindow struct contains private data only, and should be accessed using the functions below.

XfcePanelWindowMoveFunc ()

void                (*XfcePanelWindowMoveFunc)          (GtkWidget *widget,
                                                         gpointer data,
                                                         int *x,
                                                         int *y);

Callback function that can be used to restrict manual movement of the XfcePanelWindow. The function should modify x and y to set the new position.

widget : The XfcePanelWindow widget
data : user data supplied with the function
x : location of the new x coordinate
y : location of the new y coordinate

XfcePanelWindowResizeFunc ()

void                (*XfcePanelWindowResizeFunc)        (GtkWidget *widget,
                                                         gpointer data,
                                                         GtkAllocation *previous,
                                                         GtkAllocation *allocation,
                                                         int *x,
                                                         int *y);

Callback function that can be used to adjust the position of the XfcePanelWindow when its size changes. The function should modify x and y to set the new position.

widget : The XfcePanelWindow widget
data : user data supplied with the function
previous : Old GtkAllocation
allocation : New GtkAllocation
x : location of the new x coordinate
y : location of the new y coordinate

xfce_panel_window_new ()

GtkWidget*          xfce_panel_window_new               (void);

Create new panel window.

Returns : New GtkWidget

xfce_panel_window_set_orientation ()

void                xfce_panel_window_set_orientation   (XfcePanelWindow *window,
                                                         GtkOrientation orientation);

Set orientation for panel window.

window : XfcePanelWindow
orientation : new GtkOrientation

xfce_panel_window_get_orientation ()

GtkOrientation      xfce_panel_window_get_orientation   (XfcePanelWindow *window);

Get orientation of panel window.

window : XfcePanelWindow
Returns : GtkOrientation of window

xfce_panel_window_set_handle_style ()

void                xfce_panel_window_set_handle_style  (XfcePanelWindow *window,
                                                         XfceHandleStyle handle_style);

Set handle style for panel window.

window : XfcePanelWindow
handle_style : new XfceHandleStyle

xfce_panel_window_get_handle_style ()

XfceHandleStyle     xfce_panel_window_get_handle_style  (XfcePanelWindow *window);

Get handle style of panel window.

window : XfcePanelWindow
Returns : XfceHandleStyle of window

xfce_panel_window_set_show_border ()

void                xfce_panel_window_set_show_border   (XfcePanelWindow *window,
                                                         gboolean top_border,
                                                         gboolean bottom_border,
                                                         gboolean left_border,
                                                         gboolean right_border);

Set border visibility for the panel window.

window : XfcePanelWindow
top_border : show top border
bottom_border : show bottom border
left_border : show left border
right_border : show right border

xfce_panel_window_get_show_border ()

void                xfce_panel_window_get_show_border   (XfcePanelWindow *window,
                                                         gboolean *top_border,
                                                         gboolean *bottom_border,
                                                         gboolean *left_border,
                                                         gboolean *right_border);

Get visibility of panel window borders.

window : XfcePanelWindow
top_border : location for top border or NULL
bottom_border : location for bottom border or NULL
left_border : location for left border or NULL
right_border : location for right border or NULL

xfce_panel_window_set_resize_function ()

void                xfce_panel_window_set_resize_function
                                                        (XfcePanelWindow *window,
                                                         XfcePanelWindowResizeFunc function,
                                                         gpointer data);

Set a function to modify resize behaviour of the panel window.

window : XfcePanelWindow
function : XfcePanelWindowResizeFunc
data : user data

xfce_panel_window_set_move_function ()

void                xfce_panel_window_set_move_function (XfcePanelWindow *window,
                                                         XfcePanelWindowMoveFunc function,
                                                         gpointer data);

Set a function to modify move behaviour of the panel window.

window : XfcePanelWindow
function : XfcePanelWindowMoveFunc
data : user data

xfce_panel_window_set_movable ()

void                xfce_panel_window_set_movable       (XfcePanelWindow *window,
                                                         gboolean movable);

Set if the panel window can be moved by the user.

window : XfcePanelWindow
movable : TRUE or FALSE.

xfce_panel_window_get_movable ()

gboolean            xfce_panel_window_get_movable       (XfcePanelWindow *window);

Check if the panel window can be moved by the user. By default this is TRUE.

window : XfcePanelWindow
Returns : TRUE if the user is allowed to move window, FALSE if not.

Property Details

The "handle-style" property

  "handle-style"             XfceHandleStyle       : Read / Write

The XfceHandleStyle to use when drawing handles.

Default value: XFCE_HANDLE_STYLE_BOTH

The "orientation" property

  "orientation"              GtkOrientation        : Read / Write

The orientation of the window. This the determines the way the handles are drawn.

Default value: GTK_ORIENTATION_HORIZONTAL

Signal Details

The "move" signal

void                user_function                      (XfcePanelWindow *window,
                                                        gint             x,
                                                        gint             y,
                                                        gpointer         user_data)      : Run Last

Emitted when the user moves the XfcePanelWindow to a new position with coordinates (x, y).

window : the XfcePanelWindow which emitted the signal
x : x coordinate of the new position
y : y coordinate of the new position
user_data : user data set when the signal handler was connected.

The "move-end" signal

void                user_function                      (XfcePanelWindow *window,
                                                        gint             x,
                                                        gint             y,
                                                        gpointer         user_data)      : Run Last

Emitted when the user stops dragging the XfcePanelWindow. The latest position has coordinates (x, y).

window : the XfcePanelWindow which emitted the signal
x : x coordinate of the new positions
y : y coordinate of the new position
user_data : user data set when the signal handler was connected.

The "move-start" signal

void                user_function                      (XfcePanelWindow *window,
                                                        gpointer         user_data)      : Run Last

Emitted when the user starts to drag the XfcePanelWindow.

window : the XfcePanelWindow which emitted the signal
user_data : user data set when the signal handler was connected.

The "orientation-changed" signal

void                user_function                      (XfcePanelWindow *window,
                                                        GtkOrientation   orientation,
                                                        gpointer         user_data)        : Run First

Emitted when the orientation of the XfcePanelWindow changes.

window : the object which emitted the signal
orientation : the new GtkOrientation of the window
user_data : user data set when the signal handler was connected.