summaryrefslogtreecommitdiff
path: root/include/gui/group.h
blob: 88fffbc9d704d076aef03572cd61b2f5c18380e1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
#ifndef UPEM_MORPHING_GROUP
#define UPEM_MORPHING_GROUP

/**
 * File: group.h
 * Group of components
 */
#include "component.h"

/**
 * Struct: _GroupElement
 * Node of the linked list that is involved in the Group behavior
 *
 * Parameters:
 *  *component - component
 *  *sub_component - sub component
 *  *next - link to the next node
 */
typedef struct _GroupElement {
  Component *sub_component;
  struct _GroupElement *next;
} GroupElement;

/**
 * Struct: Group
 * Group representation
 *
 * Parameters:
 *  component - Component used for the Group to catch clicks and handle print to delegate to the components contented in it
 *  *group_head - pointer to the head of the list that regroup all the components contained inside of the group
 *  padding - padding for all components
 */
typedef struct {
  Component component;
  GroupElement *group_head;
  int padding;
} Group;

/**
 * Function: group_print
 * Print method for a group (BETA VERSION).
 *
 * Parameters:
 *  *parameter - pointer that will be casted into a Group to print
 */
void group_print(void *parameter);

/**
 * Function: group_init
 * Initializes fields of a Group that must be allocated before.
 *
 * Parameters:
 *  *group - group that must be initialized
 *  width - width of the current group
 *  height - height of the current group
 *  x_pos - position on the x axis from the upper left corner
 *  y_pos - position on the y axis from the upper left corner
 *  padding - space between each components
 */
void group_init(Group *group, int width, int height, int x_pos, int y_pos, int padding);

/**
 * Function: group_free
 * Frees the resources held by the group like the linked list.
 *
 * Parameters:
 *  *group - group that must be freed
 */
void group_free(Group *group);

/**
 * Function: group_add_component
 * Adds the component at the end of the chained list held by group_head.
 *
 * Parameters:
 *  *group - group in which we add the component
 *  *component - component which is added to the group
 */
void group_add_component(Group *group, Component *component);

#endif