![]() | ![]() | ![]() | Libplanner Reference Manual | ![]() |
---|
MrpResource — represents a resource in the project.
#include <libplanner/planner.h> struct MrpResourcePriv; struct MrpResource; enum MrpResourceType; MrpResource* mrp_resource_new (void); const gchar* mrp_resource_get_name (MrpResource *resource); void mrp_resource_set_name (MrpResource *resource, const gchar *name); void mrp_resource_assign (MrpResource *resource, MrpTask *task, gint units); GList* mrp_resource_get_assignments (MrpResource *resource); GList* mrp_resource_get_assigned_tasks (MrpResource *resource); gint mrp_resource_compare (gconstpointer a, gconstpointer b); MrpCalendar* mrp_resource_get_calendar (MrpResource *resource); void mrp_resource_set_calendar (MrpResource *resource, MrpCalendar *calendar);
"calendar" gpointer : Read / Write "email" gchararray : Read / Write "group" MrpGroup : Read / Write "name" gchararray : Read / Write "note" gchararray : Read / Write "short-name" gchararray : Read / Write "type" gint : Read / Write "units" gint : Read / Write
"assignment-added" void user_function (MrpResource *mrpresource, MrpAssignment *arg1, gpointer user_data); "assignment-removed" void user_function (MrpResource *mrpresource, MrpAssignment *arg1, gpointer user_data);
struct MrpResourcePriv;
A private struct for internal use only. The definition of this structure is not publically available.
typedef enum { MRP_RESOURCE_TYPE_NONE, MRP_RESOURCE_TYPE_WORK, MRP_RESOURCE_TYPE_MATERIAL } MrpResourceType;
The type of the resource, work or material.
MRP_RESOURCE_TYPE_NONE | invalid type (unset) |
MRP_RESOURCE_TYPE_WORK | work resource |
MRP_RESOURCE_TYPE_MATERIAL | material resource |
MrpResource* mrp_resource_new (void);
Creates a new empty resource.
Returns : | the newly created resource. |
const gchar* mrp_resource_get_name (MrpResource *resource);
Retrives the name of resource
.
resource : | an MrpResource |
Returns : | the name |
void mrp_resource_set_name (MrpResource *resource, const gchar *name);
Sets the name of resource
.
resource : | an MrpResource |
name : | new name of resource
|
void mrp_resource_assign (MrpResource *resource, MrpTask *task, gint units);
Assigns resource
to task
by the given amount of units
. A value of 100
units corresponds to fulltime assignment.
resource : | an MrpResource |
task : | an MrpTask |
units : | the amount of units of assignment |
GList* mrp_resource_get_assignments (MrpResource *resource);
Retrieves the assignments that this resource has. If caller needs to manipulate the returned list, a copy of it needs to be made.
resource : | an MrpResource. |
Returns : | The assignments of resource . It should not be freed.
|
GList* mrp_resource_get_assigned_tasks (MrpResource *resource);
Retrieves a list of all the tasks that this resource is assigned to. It is
basically a convenience wrapper around mrp_resource_get_assignments()
.
resource : | an MrpResource |
Returns : | A list of the tasks that this resource is assigned to. Needs to be freed when not used anymore. |
gint mrp_resource_compare (gconstpointer a, gconstpointer b);
Comparison routine for resources. It is suitable for sorting, and only compares the resource name.
a : | an MrpResource |
b : | an MrpResource |
Returns : | -1 if a is less than b , 1 id a is greater than b , and 1 if
equal.
|
MrpCalendar* mrp_resource_get_calendar (MrpResource *resource);
Retrieves the calendar that is used for resource
. If no calendar is set,
NULL
is returned, which means the project default calendar.
resource : | an MrpResource |
Returns : | a MrpCalendar, or NULL if no specific calendar is set.
|
void mrp_resource_set_calendar (MrpResource *resource, MrpCalendar *calendar);
Sets the calendar to use for resource
. NULL
means to use the project
default calendar.
resource : | an MrpResource |
calendar : | the MrpCalendar to set, or NULL
|
"calendar " (gpointer : Read / Write) | The calendar this resource uses. |
"email " (gchararray : Read / Write) | The email address of the resource. |
"group " (MrpGroup : Read / Write) | The group that the resource belongs to. |
"name " (gchararray : Read / Write) | The name of the resource. |
"note " (gchararray : Read / Write) | Resource note. |
"short-name " (gchararray : Read / Write) | The shorter name, initials or nickname of the resource. |
"type " (gint : Read / Write) | The type of resource this is. |
"units " (gint : Read / Write) | The amount of units this resource has. |
void user_function (MrpResource *mrpresource, MrpAssignment *arg1, gpointer user_data);
mrpresource : | the object which received the signal. |
arg1 : | |
user_data : | user data set when the signal handler was connected. |
void user_function (MrpResource *mrpresource, MrpAssignment *arg1, gpointer user_data);
mrpresource : | the object which received the signal. |
arg1 : | |
user_data : | user data set when the signal handler was connected. |
<< MrpRelation | MrpTask >> |