![]() |
![]() |
![]() |
Nautilus-Actions™ Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <nautilus-actions/na-data-def.h> NADataDef; NADataGroup; const NADataDef * na_data_def_get_data_def (const NADataGroup *group
,const gchar *group_name
,const gchar *name
);
NADataDef and NADataGroup are structures which handle the list of elementary datas for each and every NAObjectItem which happens to implement the NAIFactoryObject interface.
typedef struct { gchar *name; gboolean readable; gboolean writable; gboolean has_property; gchar *short_label; gchar *long_label; guint type; gchar *default_value; gboolean write_if_default; gboolean copyable; gboolean comparable; gboolean mandatory; gboolean localizable; gchar *gconf_entry; gchar *desktop_entry; gchar option_short; gchar *option_long; gint option_flags; GOptionArg option_arg; gchar *option_label; gchar *option_arg_label; } NADataDef;
This structure fully describes an elementary factory data. Each NAIFactoryObject item definition may include several groups of this structure.
gchar * |
both the id and the canonical name. Used when getting/setting properties. Is defined in na-ifactory-object-data.h and must be globally unique. Must be an invariant as it is known from plugin extensions. |
gboolean |
whether the data should be read on unserialization operations. If FALSE, then no attempt will be made to read it and the data will have to be set dynamically. When a data has been written once (see below), and unless special cases (see e.g. type), it should remain readable even if it has becomen obsolete (for backward compatibility). |
gboolean |
whether the data is to be written on serialization operations. If FALSE, then no attempt will be made to write it. Mainly set to FALSE for dynamically set variables and obsoleted ones. |
gboolean |
whether a property should be set for this variable ? Set to FALSE for obsolete variables. |
gchar * |
short localizable descriptive name. Used in GParamSpec and in schemas. |
gchar * |
long, if not complete, localizable description. Used in GParamSpec and in schemas? |
guint |
the elementary NA_DATA_TYPE_xxx data type. |
gchar * |
the default to assign when creating a new object. This default is also displayed in command-line help of nautilus-actions-new utility. |
gboolean |
write this value even if it is the default value ? Should default to FALSE. |
gboolean |
whether this data should be automatically copied when
we are duplicating an object to another ?
In all cases, the implementation is always triggered
by the copy() interface method. |
gboolean |
whether this data should be compared when we are testing two objects for equality. |
gboolean |
whether this data must be not null and not empty when we are testing for validity of an object. |
gboolean |
whether this is a localizable data when serializing or exporting. |
gchar * |
same entry is also used for GConf-based XML docs. |
gchar * |
entry in .desktop files. |
gchar |
the short version of a command-line parameter in nautilus-actions-new, or 0. |
gchar * |
the long version of the same command-line parameter in nautilus-actions-new, or NULL. |
gint |
GOptionFlags for the command-line parameter, or 0. |
GOptionArg |
the type of the option, or 0. |
gchar * |
the localizable description for the variable in nautilus-actions-new.
Defaults to short_label if NULL. |
gchar * |
the localizable description for the argument. |
typedef struct { gchar *group; NADataDef *def; } NADataGroup;
This structure fully describes a logical group of data. Each NAIFactoryObject item definition is built from a list of these groups.
const NADataDef * na_data_def_get_data_def (const NADataGroup *group
,const gchar *group_name
,const gchar *name
);
|
a NADataGroup structure array. |
|
the searched group name. |
|
the searched data name. |
Returns : |
a pointer to the NADataDef structure, or NULL if not found. |
Since 2.30