InfGtkAclSheetView

InfGtkAclSheetView — A widget showing a InfAclSheet

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <libinfgtk/inf-gtk-acl-sheet-view.h>

                    InfGtkAclSheetView;
struct              InfGtkAclSheetViewClass;
GtkWidget *         inf_gtk_acl_sheet_view_new          (void);
void                inf_gtk_acl_sheet_view_set_sheet    (InfGtkAclSheetView *view,
                                                         const InfAclSheet *sheet);
const InfAclSheet * inf_gtk_acl_sheet_view_get_sheet    (InfGtkAclSheetView *view);
void                inf_gtk_acl_sheet_view_set_editable (InfGtkAclSheetView *view,
                                                         gboolean editable);
gboolean            inf_gtk_acl_sheet_view_get_editable (InfGtkAclSheetView *view);
void                inf_gtk_acl_sheet_view_set_show_default
                                                        (InfGtkAclSheetView *view,
                                                         gboolean show);
gboolean            inf_gtk_acl_sheet_view_get_show_default
                                                        (InfGtkAclSheetView *view);
void                inf_gtk_acl_sheet_view_set_permission_mask
                                                        (InfGtkAclSheetView *view,
                                                         const InfAclMask *mask);
const InfAclMask *  inf_gtk_acl_sheet_view_get_permission_mask
                                                        (InfGtkAclSheetView *view);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----InfGtkAclSheetView

Implemented Interfaces

InfGtkAclSheetView implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Properties

  "editable"                 gboolean              : Read / Write / Construct
  "permission-mask"          InfAclMask*           : Read / Write
  "sheet"                    InfAclSheet*          : Read / Write / Construct
  "show-default"             gboolean              : Read / Write

Signals

  "sheet-changed"                                  : Run Last

Description

InfGtkAclSheetView is a widget that can show a InfAclSheet in the user interface. Optionally, it also allows the user to edit the sheet.

Details

InfGtkAclSheetView

typedef struct _InfGtkAclSheetView InfGtkAclSheetView;

InfGtkAclSheetView is an opaque data type. You should only access it via the public API functions.


struct InfGtkAclSheetViewClass

struct InfGtkAclSheetViewClass {
  void (*sheet_changed)(InfGtkAclSheetView* view);
};

This structure contains the default signal handlers for the InfGtkAclSheetView class.

sheet_changed ()

Default signal handler for the "sheet-changed" signal.

inf_gtk_acl_sheet_view_new ()

GtkWidget *         inf_gtk_acl_sheet_view_new          (void);

Creates a new InfGtkAclSheetView. To show a sheet in the view, call inf_gtk_acl_sheet_view_set_sheet().

Returns :

A new InfGtkAclSheetView.

inf_gtk_acl_sheet_view_set_sheet ()

void                inf_gtk_acl_sheet_view_set_sheet    (InfGtkAclSheetView *view,
                                                         const InfAclSheet *sheet);

Sets the sheet to be displayed by view.

view :

A InfGtkAclSheetView.

sheet :

The InfAclSheet to show.

inf_gtk_acl_sheet_view_get_sheet ()

const InfAclSheet * inf_gtk_acl_sheet_view_get_sheet    (InfGtkAclSheetView *view);

Returns the sheet that is currently being displayed by view, or NULL if there is no sheet displayed.

view :

A InfGtkAclSheetView.

Returns :

A InfAclSheet owned by view, or NULL.

inf_gtk_acl_sheet_view_set_editable ()

void                inf_gtk_acl_sheet_view_set_editable (InfGtkAclSheetView *view,
                                                         gboolean editable);

Sets whether the sheet being displayed by view can be edited by the user or not.

view :

A InfGtkAclSheetView.

editable :

Whether to make the sheet editable or not.

inf_gtk_acl_sheet_view_get_editable ()

gboolean            inf_gtk_acl_sheet_view_get_editable (InfGtkAclSheetView *view);

Returns whether the sheet being displayed by view can be edited by the user or not.

view :

A InfGtkAclSheetView.

Returns :

TRUE when the sheet can be edited or FALSE otherwise.

inf_gtk_acl_sheet_view_set_show_default ()

void                inf_gtk_acl_sheet_view_set_show_default
                                                        (InfGtkAclSheetView *view,
                                                         gboolean show);

Specifies whether the "default" column is shown, and whether it is allowed to change certain permissions to the default value or not. The ACL sheet for the default account of a directory's root node is not allowed to have default permissions. In this case this function should be called to hide the default column from the user interface.

view :

A InfGtkAclSheetView.

show :

Whether to show the default column.

inf_gtk_acl_sheet_view_get_show_default ()

gboolean            inf_gtk_acl_sheet_view_get_show_default
                                                        (InfGtkAclSheetView *view);

Returns whether the "default" column is shown.

view :

A InfGtkAclSheetView.

Returns :

TRUE if the "default" column is shown or FALSE otherwise.

inf_gtk_acl_sheet_view_set_permission_mask ()

void                inf_gtk_acl_sheet_view_set_permission_mask
                                                        (InfGtkAclSheetView *view,
                                                         const InfAclMask *mask);

Sets which permissions of the sheet to show. Only the permissions that are enabled in mask ar being shown. By default all permissions are shown.

view :

A InfGtkAclSheetView.

mask :

A InfAclMask with the permissions to show.

inf_gtk_acl_sheet_view_get_permission_mask ()

const InfAclMask *  inf_gtk_acl_sheet_view_get_permission_mask
                                                        (InfGtkAclSheetView *view);

Returns a InfAclMask specifies which permissions are currently being shown by view.

view :

A InfGtkAclSheetView.

Returns :

A InfAclMask owned by view. It must not be freed.

Property Details

The "editable" property

  "editable"                 gboolean              : Read / Write / Construct

Whether the sheet can be edited by the user or not.

Default value: FALSE


The "permission-mask" property

  "permission-mask"          InfAclMask*           : Read / Write

Specifies which permissions to show in the sheet view.


The "sheet" property

  "sheet"                    InfAclSheet*          : Read / Write / Construct

The ACL sheet the widget is displaying.


The "show-default" property

  "show-default"             gboolean              : Read / Write

Whether to show the "default" column.

Default value: TRUE

Signal Details

The "sheet-changed" signal

void                user_function                      (InfGtkAclSheetView *view,
                                                        gpointer            user_data)      : Run Last

This signal is emitted when the InfAclSheet displayed by view was changed by the user.

view :

The InfGtkAclSheetView that emitted the signal.

user_data :

user data set when the signal handler was connected.